MacTech iviaga2ine 


Environment Variables: What they are & how to use them 



The Journal of Macintosh Technology 




Anvarthed Taliles 

wtth AppleScript 
, ^.^^tndlo 


Unknown 
Shell Items 


DIY:BIND 
DNS Server 


$8.95 US, $12.95 Canada 


ISSN 1067-8360 Printed in U.$A 



















































IT’S NOT EXPENSIVE TO LOOK EXPENSIVE 
HP COLOR LASERJETS STARTING AT $399. 


With prices this low, it makes more sense than ever to get an HP Color LaserJet printer. 
Enjoy HP’s renowned print quality when teamed with HP ColorSphere toner. HP hos 
been PC Magazine’s Readers’ Choice for service and reliability 15 years in a row. 
HP LoserJets, the reliable workhorse printers for business. 


WORK 

Jjx 

" 1 







P W FASTEST 

Color LaserJet 3800n. 

* I'. Up to 22 pages a minute. 

There's no deadline it can't meet 

$899,* 

FASTER 

HP Color LaserJet 3600n. 

Up to T7 poges o minute. 

A great fit for a growing business. 

$599* 


HP Color LaserJet 2600n, 
Up to 8 pages o minute. 
More affordable than ever. 


$399. 



To learn more or see special offers, go to hp.com/go/mac. 
Call 1-800-888-3119. Visit your reseller or retailer. 

‘After $100 instant sovings. C^007 Hewbtt-Packard Development Company, L.P 
Estimoted U.S. retail price. Actual price may vory. Simubted images. 











"Can you help me with my computer?" 


Join Our Community 
Where Techs and Users Meet. 

You Could Be Helping Her! 




http://nowoncler.com 




Mac, Linux and Windows 
Help Forums and Personal Support 




















Because Apple* knows that the speed of your modern fife 
keeps accelerating, they just made the NEW Mac Book' eve 
faster so it can keep pace with your demands for produc¬ 
tivity and your need to kick back and have some fun! The 
MacBook now offers Incredible Intel Core 2 Duo processint 
at speeds up to 2,16GHz in a durable black or white 
design that includes high-speed wireless access, a built-iq 
iSighf video camera, Gigabit Ethernet | 
networking and so much more! 


f/ MacMall 
'Exclusive Deals! 

Get up to *200 cash back!' 
Parallels Desktop only 
. HP C3180 Printer FRCEr 
\Canying Case only ®9*-!y 
See Deioiv Sjr details ^ 



Apple iMac' 

■ Up to 2^“ Widescreen display 

■ Intel Coie 2 Duo piCM:es5ing up to 233GHz 

■ AlrPojt Extreme 802J1 g wirdess 

■ Bufit In iSlght " and Gigabit Ethernet 



NEW 8-Core 8f 4-Core Mac* Pro 

■ Two Dual-Core Intel Xeon processors or 
two Quad-Core Intel Xeon processors 

• Inti edible storage expansion up to 3T8 

■ 16X Super Drive (DVD i R DL/DVO+RW/CD RWl 


MacMall 
is the#1 
Apple Direct 
Reseller! 


5994^575=^979/ *mm3h 


$2194-5100^— ^2094/ »7098933 


Faster wireless! Advanced storage! Cool perlpheraisf ■ Top tools for media pros! 


Apple AlrFoif 
Extieine Base Station 

301.1 iNi/b/'yn 

»/}«i42S 


//jCll'/ 


Olfice 2004 for Mac Student 
and Teathei Edition 
r . _i 11399933 


jVps! 

l_ H c„,/I29*/ 


500GB d2 Quadra HD 
^ eSATA. FW800/400 
and USB2T) 


QuarkXPress 7 



App!^ l-lnal CuC Studio 2 



upgrade‘Hily 
Sj 


rM9ertntfikrtSl]iluWIP3c!!jige m 



lOOGSFireWire^ 
Haiti Drive 
Designed by 
r A Porsche 



#267261 


W69^! ^ 


Cot die55 Desktop' S 530 
User foi Mac 

#259804 



».n‘65”/ 


QuickBoob Pro 2007 


lor Mac 
#7119553 


only 


^178^. 



Apple 23’* Cinema 
HD Display 
#45983/ 

^>994 

n^^mi 



c'ji-Tj/ .f,.-. ■- i i::.' : v:-? ^ . 













adobe CREATIVE SUITE 3 

WEB PREMIUM 

adobecreaJ 

■''ODUCTI0l!l! 

2> 




CREATIVE SUfTr3 

I premium j 


jet online and get to work* Or get connected to 
fiends and family and share yoiir thoughts. Then 
mnd down enjoy your favorite DVDs on Its 13*3" 
flossy widescreen display, Call MacMall now for 
/our NEW MacBook and get up to speed! 

■ NEW! Intel Core 2 Duo at speeds up to 2.16GHz 
I BuHHn 802.11 n wireless, !5ight and Bluetooth 


(maiNn rebate) 


ALL-NEW Adobe Creative Suites! 


MacBook 
starting at 



The updates that every print. Web and video 

professional has been waiting for have finally 
arrived! With all-new Adobe Creative Suite 3 
applications, your creative workflow just got 
fasten rnore flexible and more productive! 
These suites offer combinations of popular 
Adobe applications like Photoshop, Flash, 
Illustrator and more! There are suites created 


# 72 ^ 77 / Financeform/rno 


NEW* Adobe Master Coliection 


#7228222 


for every type of media maven* There's even 
a Master Collection that includes EVERY 
application in one package! Call MacMall or visit 
our Web site to find the perfea match for you! 

NEW Adobe Creative Suite 3! 

Upgrades from‘^393*^! 

NEW Illustrator CSS! 

Upgrades fromWS^! 

NEW Photoshop CSS and 
Photoshop CSS Extended! 

Upgrades from ^195^! 


Apple MacBook Pro 

New models 
Just announced! 

Too late to print! 

Call today for details! 

5a994-$i5o=^7844.^‘ #7133508 


MacMoll is your 
source for LCD 
and plasma 
widescreen TVs! 

Panasonic. 

3^wSonic* 

SHARP. 



f FREE 

rfMTfanemltter! 


iPod shuffle in five new colors! 

■ Holds up to 240 songs 

■ Amazingly small—only T07“ tall 


#7098940 


iPod” With Video 

■ Now offers up to 
80GB of storage 
« Download and play 
cool games 
starting at 


^ FREE > 

=MTranimlti6i'S 


30 GB iPod U2 
Special Edition 

• Holds up to 7,500 songs, 
up to 25,000 photos or 
up to 75 hours 


iPod'nano 

■ 2GB model holds 
up Co 500 songs 

■ TS" color LCD 


#7098947 


rpREE^ 

a^aviTig 

(sefeltnctteSs), 

^jransmltti^ 


#7098953 


Starting at 


7098945 



1-800-328-2794 

Visit us at macmall.com 

Source Code: MACTECH 













CRM. 

SALES. 

INVENTORY. 

PLANNING. 

MANUFACTURING. 

DISTRIBUTION. 

PURCHASING. 

SHIPPING. 

PROJECTS. 

FINANCIALS. 


Enterprise software, 
all working together. 

All on a Mac. 


www.OpenMFG.conn 









Articles & Departments 


AppleScript and Apple Remote Desktop 
Automating an automation Zoo/ 

By John C Welch. ....* 


A/loc in the Shell 

More from the Unknown 

More sh^i tools that typically go unnoticed 

By Edward Marczak . 


DIY: BIND DNS Server 

How to turn OS X client into a fuK-featured DNS serum 

By Ben Greisler .. 


The Road to Code 

The Courage to Start 

Take the first step toward programming for Mac OS X 

By Dave Dribir) .. ., 


Environment Variables 

How to leverage open source applications in Mac OS X 10.4 

By Philip Rinehart ... 


Advanced Tables with AppleScript Studio 
Learn how to suppwf eiRtable tables and drag-and-drops 

By Jose R.C. Cruz ... 


Using NetBooting on the Mac OS X Server 
for delivery of mass client deployment 

by Criss Myers . 


MacTech Spotlight 

Steve Modica 

CTO, Small Tree Communications 


Table of Contents 














From the Fditor 


M M M clcorTic to llie July i.sj^ue of MacTech - sanietlaiiig weVe loosely referring to as die prog/^a/iunin^ issue. 

See, Mac lech started ofl life as a programmer's jcuirnal. lliat was in 19fH, for ihose of you thal d<^n’L 
mm remember back that far The devekjper market has gone through many changes, and, MacTech lias, 
W m too, along with it. Bring us up to the [>reseni, and there’s probably no Ix^tter time to |ump into some 
kind of development, 'lliere are new tcx)ls and utilities that help a developer - one of almost any skill level - 
turn the idea in their head into a functioning application. Of c:ourse, while a pencil allows me to draw, Tin no 
arf/si. However, through [iradice and learning from the masters, you can be a developer of some success. 

Tills month, we Ye very, very pleased to introduce a new column, "The Road to Code " Authored by Dave 
Dribin. The Road to Code gets you started along the path of becoming a Macintosh Programmer. WeVe had 
requests from people - sysadmins included - that w^ant to dive in deeper, write their own apps, or at least liave 
the ability to read source code. Think about ii: youYe a sysadmin and cron isn't doing just what you want. Well, 
you can download the version of cron thal is usexJ in OS X and modify it to your liking, or simply read the source 
and then know why it is tehaving as it is. You can then even file a bug repeal with the solution to the issue, if 
you like! This first c'olumn stans us off with the basics of C and XCtxIc so we're all starting from the same 
founcLiiion. Never fear, llK)ugh, we’ll be up to Objcctive-C, Cocoa and other topics before you know it! You'll 
also find Dave hanging out on Apple’s Cocoa*dev list from time to time, and contributing to the Mac community 
through his blog at httpr/Zwww.dribin.org/dave/blog/ 

John Welch returns with a topic that should interest all system adininistrators out there, laige or small, He 
teaches us how to automate Apple Remote Desktop using AppleScript. To quote John, "the best sysadmins 
are lazyY lliis is why you need to learn how to automate an automation ttx>l like ARD. John gives us several 
exampleii with great example AppleScript code. 

BenGrelsIer brings us anolftei- way to increase tlie vakie of a machine we already have: Take a stajidard 
OS X machine and turn it into a DNS server - no additional siiFtware required. Having a secondary (or tertiary) 
DNS server available when youYe serving DNS is really critic al Ji's also a nice way to oflload kxjkups from a 
main machine that tnay be doing oiiicr things as well (like running as an OpeiiDireclory master), 

JoseCim teacher us about using tables in Apj^IeScrijX, along with presenting those tables in a (7dll using 
AppleScript Studio. Yables, or 'grids/ are a common and important way to display data. Ediiiihlc tables arc even 
cooler. Jose tiikes us ihrough doing jusi ihis in “Advanced Tables with AppleScript Stndio.’' 

Our MacEnterprise feature this month IVom Philip Rinehart talks about an interesting, if noi little-known 
feature of OS X, OS X has the ability to bring shell variables into the GUI. However, a pieev of that changed 
when Apple rolled out Seairiiy Update 2007-004. Of course, there are applications out there that rely on thfs 
functionality. So, how do you work around this new limitation? Check out what the MacKnterprise community 
came up with! 

Want some tips and tricks on serving up Netboot iiviages for multiple Macs? Crlss Myers brings you his 
teclmit|ues to having your macliines up and running from a Netboot server. 

Finally, w^e feature Steve Modka in our MacTech Spotlight tills month, Steve is the founder and CTO u{ 
Small Tree Communlcatioiis, which many of us know from tlieir unique networking prcKlucts for the Mac 
platform. The original (and ai one point only) scjurce for multiple-Eihernet cards for Macs, we Ye looking fojward 
to the next round of innovation from Small Tree. 

Fnjoy the i.s.sue - we're here playing with all tsf iliis on our shiny new Leopard Betas, making sure we can 
bring you the most up to dale infonnation when it ,sliips in Octcjber! 


Edward Marosak, 
Executive editor 
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THE PATCH PANEL 

AppleScript 

and Apple Remote Desktop 

Automating an automation tooi 




by John C. Welch 




Welcome 

Ah, hack agiiin; into the breach, and iliis tiine, we ItKjk at 
two of my favorite Uk)Is, AppleScript and A[>ple HenKite 
Desktop. I am not exaggerating in the least wlien I say that the 
day 1 found out that Apple Remote Desktop is st:iiptahle, was 
the d;iy that Apple Remote Desktop rinally lx-*came, in my eyes, 
a 'real’ sysadmin ick) 1. Why? Weil, the best sy,stRlmins are la?^y. 
We don't like doing monkey work, especially repetitive 
monkeywork; hence our love for st ripling. We also reali?:e that 
the more manual a proce,ss is, the more prone to error it 
becomes. Even if the script b buggy, a script is going to do a 
task tile Siime way every time. The more we can script 
repetitive tasks, the more time we have for work that require.s 
a human, and the fewer errors siiid tasks will have. 

The Basics 

To look at ApfileSc'ript in Apple Kemole Desktop, we first 
have to see what we cim and cannot do with Apple Reintite 
Desktop's scTipiing implementation. Once that's done, we can 
we can get to work. As it turns out, it’s simpler lo just 
categorize what you can’t script, and then you know you can 
scrip! everything else. 

You can't directly set Apple Remote Desktop preferences, 
you can’t aulheniicate new machines into Apple Remote 
Desktop, you can't scrifit reports, and most computer 
projKmies are read-only directly via AppleScript. Note that you 
am set quite a few' properties via the sysiemseiup command 
and other command line applications, and you can use 
AppleScript lo do this, but Apple Remote Desktops dintonary 
doesn’t yet offer you a way to say, change ilie IP address of a 
computer. 

So, what can you do then? Well, in three words- Tasks, 
Tasks, and Tasks. You can also modify computer lists, i.e. 
create them, add computers to them, etc. But tlie l>ig thing is 


tasks, 'there are something like 23 separate tasks that you on 
run within Apple Remote Deskiop, so even w'ith the limitations, 
its not useless at all, 1 have to give kudos to the Apple Remote 
Desktofi team for giving us a more than usable dictionary in die 
first implemenialion of AppleScript in Apple Remote Desktop, 
li is much lietter than some of the other first implementatitins 
Tve seen, like Keynote or Rages, li’s not everydiing, but it’s a 
great first step. 

The Dictionary and Usage issues 

S{>, wadi the liniiiations in mind, how is the dictionary 
when youTe wajrking with it? Not bad at all. There are some 
issues, such as some really stilled class names. Every task class 
name ends with “task"; .so when you're doing a lot of work, you 
gel tilings like “set theTask to make new set network 
startup disk task..." Ifs not a huge issue, but it's tedious 
after a w^liile, and you start thinking ahoui old ‘Department of 
Redundancies Department jokes. The other annoyance here is 
that you have to make ihe task then execute ifie task in a 
se pa rate c:ommancl. It wiuild be much nicer to be able to just 
build and execute the task in one line. (Yes, 1 know, it should 
lie theoretically possSilile, Inn the mnli is, Tve never had it work 
right in one statemenij 

If you are doing a “copy items task" or "copy lo me task", 
(1 think that splitting this into two statements W'as kind of silly, 
liut to nor give them m«ire similar names, i.e. “copy items to me 
task" is even sillier. Consistency is important, even to 
sy.sadmias.), and you want to display a list of the “standard" 
destinations, such as /Appl lot ions, ei al., you get instead a list 
of the 4-charac'ier AppleScTipl ctxles for them. 'There are a 
numixT of reasons for tliis, but in any event, it means [|uiie a 
bit more work if you want to put it in front of someone who is 
a newbie in the sysatlmin or Apple arenas. 
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Sj^eaking from a stricter POV, there are a lot of things in 
Ihe Apple Reniole Desktop clictionar^^ that could have lx.^en 
clone heller, and hopefully, as items arc added to it, tliose will 
be improved, ikit for now, what you have is not a sharp stick 
in the eye. 

Scripting Apple Remote Desktop 

So with all that in mind, let's kwk at whai scripting Apple 
Remote Desktop Ls like. First, rememlKT that other than list 
sellings, ever\ihing you do is going to ix" a Ixtild Eask./execute 
task"* pair-- a tedious process, but not eviHy so. 

One (f the fir.st things I've done, due to Jiiy admittedly 
al)norinal w^orkllow whieli involves far more system jebuilding 
than rd like, is to simpliJy tJie setup of various computer lists 
thal I know HI use all the time. First, 1 create die lists: 

tell application ‘’Remote Desktop" 

set theComputerUst to {"President's Office", "Communications",-! 
"Print Shop", "Home", "Consulting", "Admin Macs", "Virex Updates"} 
-source list for computer Hsls 
repeat with x in theComputerUst 
make new computer fist with properties {name:x} -iterate 

- through the list 
end repeat 

end tell 

Six lines, IniE it sets u[) oiy standard lists ralJier nicely. 
Since a few of niy Apple Remote Desktop scripts are designed 
to run against hardcoded lists, making sure these lists alw^ays 
have tlie same name is eritiral (Yes, I know, hardeoding bad. 
I lowever, there’s a bug in the Apple Remote Desktop 
AppleScript implementation where you can’t just get the 
.selected list. You on get ilte .seleeled computers IN the list, but 
not the selected list itself). Once that’s done, we add computers 
TO the iist(s): 

set theListafUsts to {} -I like to make sure of things 

tell application "Remote Desktop" 
set theListofLists to name of every computer list --get ait existing 
- fists 

set the Destination Lists to choose from list theUstof Lists with title-3 
"Computer Lists" with prompt "Pick the computer list(s) you want the-i 
selected computers to be members of" with multiple selections -i 
allowed 

-i have quite a few computers in muftipie lists, so this iets ms do 

- that if I wish 

try -wonkamund for no choice 

if (length of the Destination Lists) * 0 then —if there’s no choke in 
- choose list, this actually errors out silently 

if (length of theDesti nation Lists) = 1 then -if there's onty 
— one destination 

set theComputers to the selection ^ef the list of 
-seiections 

if (length of theComputers) > 0 then -no empty 
- selections (REMEMBER ABOUT ARD AND 
-THE CONSTANT SELECnON) 

set theOestinadon to item 1 of the Destination Lists 
-get the destination list name 
repeat with x In theComputers 

add X to computer list theDesti nation -add a 
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-- computer to the list We have to use the key^flford because 
— of how choose list works 

end repeat 
end ff 

else -multiple destination lists 

set theComputers to the selectmn -get the !M of 

- setectjons 

if (length of theComputers) > 0 then -no empty 
*- seiecf^^ns (REMEMBER ABOUT ARD AND THE 
-- CONSTANT SELECnON) 

repeat with x In theDestinattonUsts -otJfer loop 
repeat with y in theCompyters -inner loop 
add V to computer list x —add the 
-computer to the list 
end repeat 
end repeat 
end if 
end if 
end if 
end try 
end tell 

This one is ii l)it more complicuietl, bin only due to ihe 
logic in checking for 0, 1 or more iJinn (3ne compuler or 
destination list selected, llie reason 1 have ""KEMEMliER 
ABOUT ARD AND ITiE CONSTANT SELECTION" in many of 
the connnents is tliat i[i Apple Remote Desktop^ it^s imprissible 
to have no computers selected in any list. There is always at 
least one selected c'omputer. I consider thi.s a l:»ug, you may not, 
but rather than assume Apple Remote Desktop will have this 
l:)ehavior until the end of time, Tm pnractivc al)out handling 
zeros just in case ARD get.s fixed. 

Now we have our lisLs set up. What's next? Well, we make 
sure that they’re up to date. Now ihcre're two ways to do this. 
The brute force way is to just select the computers and run all 
the updates. In ARD, since it doesn't yet support miming 
Software Update in the GUI, you’d either have to run this via a 
Unix command, or via AppleScrijM: 

tell application ’’Remote Desktop” 
set theScript to "softwareupdate -ia” -build the command for the 
Unix task 

set thelask to make new send unix command task with properties-i 
{showing output:!rue, user; "root”, script: theScript} -build the task 
set theClients to the selection 

if (length of theCltents) = 0 then -no sense in whiningf and with 
-- the way Apple Remote Desktop wort<s, Vm not sure this condition 
- fs possible, so an empty seiecticn fails silently 
else if (length of theOients) = 1 then 
try 

display dialog "By default; ARD always selects the topmostn 
computer in a list. If this is the computer you want to upgrade, click-t 
the V'OkayV button” 

"7?7(s is 3 warning I put in, because ARD ^always selects 

- the ftrst client in a computer tist, so whiie that avoids 
-a problem with an empty selection, it can create a 
-problem if you donT notice that the wrong computer is 
—selected 

-I only ask this if a single computer is selected 

set theTaskResuR to execute theTask on theClients -run the 

— task, save the results 

end try 

else if (length of theClients) > 1 then 

set tneTaskResult to execute theTask on theClients -run the 

- task, save the results 

-I use an else if, because I don't want any default that would 
--run the task outside of the specific desired situation 


end if 
end tell 

Tliis is functionally quite simj^le. Build die Unix ctmariand, 
“sofitwareupdare -la" to install aU available updates, build the 
'"send Unix command ia.sk’' rhat uses that command, tlien run it 
on die selected systems. Note, you could code this to mn on 
every computer in a given list, etc. One thing to note here: Apple 
Remote Desktop lets you nm renic^te Unix comniancLs as root 
without additional aullicnLicaiion, If you t:an mn Apple Remote 
Desktop, you can mn commands on any clieiil llral copy of the 
Apple Remote Desktop administrator console has access too. 
Tliis is convenient, liul am lie dangerou.s tex), so be careful. Note 
iliat it’s not limited to rcx}t. You cai^ run tliis as any valid user. 

Because Apple Remote Desktop always selects one 
compuleq 1 pul in a warning when you mn it against one 
ccmiputer, just in case the default selection is a computer you 
didn’t want to run this on. Also note rhat you can save the 
results of ’'the send unix command task”, lliis comes in handy 
if you need to use those results in your script. 

But what if we don’t want to install every update blindly? 
Well, then we’d need to get a listing of die updates we want to 
install: 

tell application "Remote Desktop" 

set theScript to "softwareupdate -I" -build the command for the 

— Unix task 

set theTask to make new send unix command task with properties-i 
{showing output:true, user: "roof, script:theScript} -bulid the task 
set theClients to the selection 

if (length of theClients) = 0 then -no sense fn whining, and with 

the way Apple Remote Desktop works, I'm not sure this condition 

- is possible, so an empty seiecilon falls silentiy 
else if (length of theClients) = 1 then 

try 

display dialog "By default; ARO always selects the topmost-i 
computer in a list. If this is the computer you want to upgrade^ dick-j 
the \"Okay\” button" 

- This is a warning 1 put in, because ARD *always* selects 

- the ftrst client In a computer list, so while that avoids 
-a problem with an empty selecdon, it can cneate a 
-problem if you don't notice that the wrong computer is 
-selected 

-I on/y ask this If a single computer is selected 


set theTaskResult to execute theTask on theClients -run the 
-task, save the results 

end try 

else (f (length of theClients) > 1 then 
set theTaskResult to execute theTask on theClients --run the 
- task, save the results 

-I use an else if, because I don't want any default that would 
-nm the task outside of the specific desired situation 

end If 
end tell 

Tlie only real difference here is die Unix command used. 
Other than that, it's preiiy much the -same script. From there, I 
run the install commands manually, because tliey’re rarely all 
the same for every computer in a list, however scripting that 
part would be fairly easy. But all of these require some manual 
interventiun. Wliai if you ju.st want to do .something without 
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having to select anything? Like say, atn a third party ufxlater 
against a constant scH of machines in a constant list? 

For tJiai we combine tlic power of f<)kler actions with 
Apple Remote Desktop scripting: 

on adding folder items to theFolder after receiving theAddedItems 
-teffdppiication Tinder'' to sef IheFolderName to name of 
-theFofder 

repeat with x in theAddedItems 
set theRleInfo to info For x -get info for the downtoading hie(5) 
set theBaseSize to size of theRleinfo iaitiBl size 
delay 3 -wait S seconds 
set theFlleJnfo to info for x «get info again 
set theCompareSfze to size of theFileInfo -get a newer size 
repeat while theCompareSize theBaseSize -if they don^t equaif 
- loop untii they do 

set theBaseSize to theCompareSize -nesv base size 
delay 3 -wait three seconds 
set theFilelnfo to info for x -get info 
set theCompareSize to size of theFilelnfo -get a newer size 
end repeat -once the sizes match, the download is done 

end repeat 

tell application ''Remote Desktop" 
set thePackagelnstall to make new install package task witti-i 
properties {delegating to task server:false, encrypting:true,-i 
packages:theAddedItems, stopping on error:false} 

set theTaskResult to execute thePackagelnstall on computer list^ 
"Vi rex Updates" 

display dialog (status of theTaskResult) giving up after 60 

end tell 


end adding folder items to 

TTie outer loop is a folder aditjn thal runs when a File or 
files are copied or added lo a given folder. 1tie repeat - delay 
loop is to work around a quirk in this folder ad ion where ii will 
sometimes start tefore the file(s) have finished copying. Once 
thai's done, w'e have the Apple Remote Desktop-specific code. 
First, we hiiikl ihe install f>ackage text. I don't vuse an extemai 
task server, so that's set to false. 1 (of course) enable enciyption 
for this task. By a happy <x)incidence, die way you enumerate 
ihe package<s) to Ik* installed via tliis task is as a list. ITiis is 
convenient, because the w:\y this folder action deals with the 
files you are adding is as a list. So there’s no need to change 
anything alx>ui ilu* list of files you use in the folder action. Yon 
just pass it along to Apple Remote Desktop. We also set the task 
to not halt execution on error. Just l>ecuLise .some of the taigets 
have issues is no rtuson to stop everytlting. Once that's done, 
we run the task and save the result. 

The a^suU is a record, and we use the value of that record 
to pop a dialog tiiai tells iis what happened, so we don’t have 
to watch Apple Remote Desktop. I mean, if we’re going to stare 
at Apple Remote Desktop, why bother stiripting it? I originally 
wrote this script for my Vi rex updates, hence the list name. 
Obviously, you can apply this to any list you ch£X>se. 

So, ytju alUicli this script to a folder, and the nexl lime you 
have to rim an installer on that list, you ju-st drop that installer 
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in the folder. Barring it noi runnifig on one or more laigets, 
Limits it. No .selecting, no watching Apple Kemote Desktop. 
Drag, drop, and go on alx>ui your business. Thai's vvfiai I like. 
Let the software do the monkey wt)rk, IVe liettcr things to do. 

SerioiLsIy ihougli, wlien you start ctjnibining things like 
folder actions with ARL), that's when you .start seeing the real 
convenience of the applic^iition. If you're building your own 
installer, just have dje final step 1 k" to save it to the proper 
folder, and once the save is done, the install is happening 
automatically. Automation does not suck. 

iSpeakirifr of auioimtion - a wore/ on Autontutof^ Pretty 
much anydj/ng you can do vm App/c*LS'cT/pf, you ran hiiiid an 
Autoinafor nK>e/uie /bn i just don’t happen to use Automaton hut 
you a)uJd easily apply these' scripis to Ainotruitot:) 

What if you need to push out a new version of an 
aj^plication tliat is installed via drag and drop in /Appliaitions? 
Q.Hd>: 

on adding folder items to theFolder after receiving theAddedItems 
•fe/r application ’"Finder" to set thefolderName to name of 
" theFoider 

repeat with x in theAddedItems 
set tbeFiielnfo to info for x -get info for the downioading fffe(s} 
set theBaseSiie to size of theRieInfo initial size 
delay 3 -wait 3 seconds 
set theRleInfo to info for x -get info again 
set th^ompareSize to size of theRleInfo -get a newer size 
repeat while theCompareSIze t theBaseSize -if they don’t equal 
” loop until they do 

set theBaseSize to theCompareSize **neiv base size 
delay 3 **wait three seconds 


set theFlIelnfo to info for x -get info 
set theComparesize to size of theRleInfo -get a newer size 
end repeat -once the sizes makhf the download is done 
end repeat 

tell application "Remote Desktop" 
set theApplicatfonCopy to make new copy items task wlth-i 
properties {conflict resolution . replace, copy items: theAddedItems,-* 
entjyptingitrue, location:applications folder, ownership:destination-* 
folder owner, stopping on error:felse} 

set theTaskResult to execute theApplicationCopy on compirter-i 
list "Software Updates" 

display dialog [status of theTaskResult) giving up after 60 
end tell 

end adding folder items to 

there's really ntH a lot of difference I>etween the in.staller 
siTipi and ihe copy script. Again, we lei the folder action handle 
[rassing the filefs) to lx* copied to ihe copy items task. Since it's 
going into /Applications, we set the destination icr 
applications folder. We set the pennis.sion.s ,so that the 
ap()lication is owned by the owner of /Applications, and we 
don't w'anr it to halt on error 

Something a bit more complex 

Now this is all good stuff, and I use these. But whai alKnil 
something a bit, oh, ctx>ler? For example, while Apple Remote 
Desktop allows a client computer to sigtial the administrator, 
tliat pretty much rec|uiies you to have the Apple Remote 
l)t:.skLop menu item running. Ikiwever, there are a few reasons 
wily you wDuldiit want this nmning. So then what? If you're in 
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I he room, say in a kb, dien liiey am get your uttention with 
ease. But what it' you’re in a different building? Rniail^s an 
option, blit only if you read it. How a[)oui if they could send 
you an emaii tliai would tiien l:>e processed by the eniaii client's 
scripting facility, and dien tell Apple Remote Desktop to open 
an observe wintlow to that ciienL^ 

You'd liave a neat set of scripts like the ones I toyed with 
a w'liilc ago. Tliis requires the XMail OSAX from Lestang.org at 
http://www,lesiang.org/nil>riciue9.htmL There aa- a few pieces 
to this setup. First, we have die client piece: 

property theSenUerEmailAddress : "" -fiH in here with the appropriate 

- origination emaii address, you could probabiy paii this from the 

- system if you ivant 

property theSenderUserlD :"" -ema^T osenfd for the sender 
property theSenderPassword :"" --emaii password for the sender 
property theRedpientEmailAddress ; -trie account that gets the 

- rietp nepuest emaiis 

property tfieSMTPServer ; -smtp server this apptorion uses 

set theSystemlnfo to system info -grab various bits of info. 

“fee/ free to modify tbr your needs 

set theiiserUongMarne to long user name of theSystemtnfo 

set theOserShortName to short user name of theSystemtnfo 

set theUserlD to user ID of theSystemInfo as text 

set theComputerName to computer name of theSystemInfo 

set theUserHomeDir to home directory of theSystemInfo as text 

set thetPAddress to IPv4 address of theSystemInfo 

set theSy stem Version to system version of theSystemInfo 

-have the user enter a short prabkm description 
set theHelpRequest to text returned of (display dialog ‘"Enter a-i 
*short^ tecription of the probiem and eiick \‘'0K\"" default answer^ 
"enter short description here") 

-build the emaii contents 

S€t theMessageContents to "User: " a theliseilongName & " 

“ & "User Short Name: " & theUserShortName & "-i 

- & "UserlO: " & theUserlD & % 

" & "User Homedir Path: " & theUseitiomeDir fit 
" & "Computer Name. " & theComputerlMame & "-i 
" & "Mac OS X Viersion! " & theSystemVersion 8t % 

" & "System IP Address: & thelPAddress & "-i 
Needs help with: " & theHeipRequest 

-this uses the Xmait OSAX (in the bundle) to send a message. 

-IVs a pretty sweel bit of work, and guite flextble^ 
send mail to theRedpientEmailAddress from theSenderEmallAcklress-i 
subject "Student Help Request!'^ body theMessageContents username -i 
theSenderUserlD password theSenderPassword authentication auton 
port S87 priority 1 SMTP server theSMTPServer without ssl 

Pretty simple. You manually set up a few pro|x:rties and 
then cx)py this to ali tlie dienes. Wlien they run it, it pulls in 
some l)asic information from system info, l>uilds a message that 
is designed to lie easily parsed, tlien sends it witli the Xmail 
OSAX. 

From I here, we move lo tlic next script, which is kicked 
off by a Microsoft Entourage Rule thai uses the suhjeci line 
“Student I Iclp Request" in a mail rule lo am our second scri[>t, 

I did gel this working witli Mail, liut Mail's AppleScript 
implementation in Mac OS X 10,4 has .some extreme issues, 
and required a third folder action script to get it lo work. If 


anyone wants k, email me at jwelch@bynkii,com and I’ll send 
it to you. 

The script Entourage kicks off is; 
property theMessageBodies : {} 
property theLongUserName ;"" 
property theShortUserName : "" 
property theUserld : "" 
property theHomedirf^th :"" 
property theOSVersion :"" 
property thelPAddress :"" 
property theProblem : "" 
property theComputerName :"" 

—this is the entourage-specific part ond Is how we gef the message(s) 

— that set o ff the ruie 

tell application "Microsoft Entourage" 
set theMessageBodies to {} 
set theMessagelJst to current messages 
repeat with x in theMessageList **17016 that you*ie usually only 
“ going to riave one message at a time. However, it‘s aimys a fist 

— so we get more ffexibility for the same amount of code 
set the end of theMessageBodies to the content of x 

end repeat 
end tell 

set oldDelims to AppleScript’s text item delimiters —if you notice, I use 

— a iol of tabs in the emaii body. This is why 

set AppleScript's text Item delimiters to " ’ -*use faris as the 

— deiimiters 

repeat with x rn theMessageBodies 
set theM^sage to every paragraph of x -iist of paragraphs, one 
-line per item 

set theLongllserNameParagraph to the Hfst item of theMessage 
-you can really do ail these steps in one line per step 
set theLongUserName to the last text item of ^ 
theLongUserName Paragraph -but! wanted to make it more dear for 

- newbies 

set theShortUserNameParagraph to the second item of theMessage 
-this is where we grab the individual data bits for the aiert 
set theShortUserName to the last text item of -i 
theShortUserNameParagraph -you couid easiiy format the email 
-message so that it 

-already had the structure you want and just dump ail the 
-wntents into the alert in one step 

set theUserlDParagraph to the third item of theMessage 
set theUserld to the last text item of theliserlDParagraph 

set theHomedirPathParagraph to the fourth item of theMessage 
set theHomedlrPath to the last text item of ^ 
theHomedirPathPa ragraph 

set theComputerNameParagraph to the fifth item of theMessage 
set theComputerName to the fast text item of 
llieCo m pu terNam e Pa ra graph 

set theOSVerslonParagraph to the sixth item of theMessage 
set theOSVersion to last text item of theOSVersion Pa ragraph 

set theiPAddressParagraph to the seventh Item of theMessage 
set thelPAddress to the last text item of thelPAddressParagraph 

set theProblertiParagraph to the eighth item of theMessage 
set theProblem to the last text item of theProblemParagraph 

-display the alert message 

display alert theLongUserName & " is having a probfem" message-i 
"Computer: " & theComputerName & " 
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IP Address: 8 l thelPAddress 8 l ” 

OS Version: " & theOSVersion & " 

Homedir Path: ’ & theHomedirPatb & " 

UID:" 8t theUserld & " 

Problem: 

" & thePmblem giving op after 45 

tell application ’’Remote Desktop” —te// Apple Remote Desktop to 
— pop the observe window 
observe computer theComputerf^ame 

end tell 
end repeat 

set AppleScript's text item delimiters to oldDelims -reset your delms, 

- c/eaoop is good 

tell appircatton "Remote Desktop" to activate -bnng Appie Remote 

- Desktop to the front Reaiiy, you don't need 

Tlie email comes in and we tell Kntoura^e u> give us the 
content of the email. We llien use tile tabs in the email in 
conjimetion wiili AppleScript’s Text Item Delimiters, so we 
can pull the content we need out of the email with ease. 
From there, we fire off a dialog to the adtninistrator telling 
them that a client has a problem, and then tell Apple 
Remote Desktop to open an observe session to that 
computer. Pretty spiffy. 

Conclusion 

1 haven’l even come close to llie full potential of what 
you can do with Apple Remote Desktop's AppleScript 
im[)lementaiion, but I hope Tve given you some neat ideas 
that point you in the right direction. 
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Mac In The Shell 


by Edward Marczak 


More from 
the Unknown 

More shell tools that 
typically go unnoticed 
V _/ 


Tiiis will conveit the Microsoft Word-based "resume.doc'' into 
a separate HTML document named “resume.htmr* Til 
immediately [K)int out that textutil writes much, much 
l>etLer HTML titan Word. 

Note that the input Format is deiennined ^automagically' 
by a number of methods. If textutil misidenritles the formal of 
tile source file, you tell it with the “-format” swiicli: 

cOKtutil -format html -convert rtf fllel 

This will tell textutil that “fileT* is an HTML file, and we 
want to convert it into a rich text format file named ‘"ftlel.rtf’. 

There's also a very handy “-info’* switch that returns info 
on a given file; 


Introduction 

OS X has an incredible breadth and depth available in 
the tools accessible from a shell. So much so, that it's hard 
to know each and every tool available. Some are almost 
hidden: tucked away in places one does not typically look. 
Others are hidden in plain sight: exactly where you'd expect 
them, but buried among tlie volume. This month, Tm going 
to dig out and introduce stmie more osefiil shell tools that 
you may not know about. 

text manipulation 

It’s long been the domain of scripting languages like perl, 
and perhaps now itj a lesser extent PI IP, to slice, dice and 
otherwise manipulate text. However, there’s a framework 
built right into OS X, so why not take advantage of it? The 
Cocoa text system is exptjsed to the sliell via ihe 
‘“textutil" application, “textutil" can convert and 
manipuiare many differeni fiirmais of text dociimenis. In fact, 
it works with a surprising numlxT formats: 

txt 

html 

Microsoft Word “doc" 

MitTOSoft Word XML 
rtf 

weharchive 


$ textutil -Info 2007-01 ■Oti\ Logs,doc 

File: 2007-01 Marczak On Logs.doc 

Type: Word format 

Size: 23600 bytes 

Length: 3746 characters 

Title: MacTech Template 

Author: Claasica Department 

Last Editor: Edward Harezak 

Compa ny: R ad1ot o p e 

Subject: 

Keywords: 

Created: 2006-11-02 l/:3b:00 D500 

Last Modified: 2006-11-06 09:47:00 -0500 

As you can see, documents sometimes have incorrect 
metadata. Well, textutil can help you handle that as well! 
There are a number of metadata related switches: 

strip: Remove metadata in target during conversion, 
title: Set the title metadata attribute for output files, 
author: Set tlie author metadata attribute for output files, 
suiijea: Specify the subject metadata auribute for output 

files. 

keywords: a shell-quoted list of ‘tags* 

(“ key word l,keyword2, „/) 

comment: Set the comment atlrif^ute for the output files, 
editor: val Set the cditt>r attribute for output files, 
company: val Set the company auribute hr t>uiput files, 
creationtime: Set the creation time attribute for output 
files (in “yyyy-mm-ddTlih:mm:ssZ’' format), 

modificationtime: Set the modification lime attribute for 
output files (in “yyyy-mm-ddThh:nim:ssZ*' fomiat). 


It's also incredibly easy to get started. Using the “-convert" 
switch, you can accomplish most conversions that you'd ever 
want: 


So, we could create an HTML doaiment from a plain text file 
witli the title and keywords set by nmaing textutil like 
diis: 


textutil -convert html resume,doc 


textutil -convert html title "Anti-gravity Thesis" - 
keywords "(anti,gravity,'atam powerphysics)" author 
"Bruce Banner" ag-file,txt 
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You'll find a wcll-forniccl HTML filu with a Utile l>it of 
CSS. Of course, there are many times when you need finer 
control over the tags that will be used in that H'fML. Have no 
fear! The ‘‘-exdiKledelemenLs" switch can help you oui. Tliis 
swiicli allows you lo sf>eLify wliich HTML eienienis should 
nor be used in ihe generated irfML. Like the “-keywords'* 
switch, “-excludedelements" expects a single argument, so 
you can use a sliell-C|noted list of tags to skip* 

Keep it clean 

.Speaking of wellTonned HTML, manipulating tags and 
theii parameters is a special case of text manipulation. 
Fortunately, tidy, the slancbrd Unix ulilily just hir this 
purjK)se, ships with OS X. So, if youVe used textutil to 
generate iriML based output, tidy can rake you even 
funher. 

The simplest case lets tidy modify your HTML 
document in place* To do so, use ihe “-m“ switch: 

$ tidy -im ag-file.html 

Info: Doctype given is " //W^C//J)TD UTML 4*01//EN" 

Info: Document content looks like HTML 4.01 Strict 
No warnings or errors were found * 


Take Uxjk ai your file before and after running the tidy 
command. I also like to include the "-i" switch, which ensures 
tag levels are indented appropriately. Also, by default, tidy 
will lowercase all lags (wlhcfi, by me, is “correct"). This can 
be overridden with the "-u'' *swiich. 

One of my absolute favorite use.s of tidy is to get rid of 
“illegal" characters. Thi.s is easily accomplished with the “-b" 
(bare) switch. Tills strips the document of smart quotes, and 
dashes, and other characters that cause problems in H fML 
documents. 

There's iiiucli, mudi more tliai tidy cun do. Check the 
very well written man page to look at more options. Don't 
forget, though, that you can combine textutii and tidy 
into one neat shell siaieineril: 

textutil -Stdout ag filc.txT convert Htttil | tidy i - 
output ag-file.htrai 


This comimnd uses textutil to convert a text file to HTML, and 
sends the oiilpul to stdoul* Then, that output is piped to tidy, 
which then requires u.s to use the “-output" switch to write the 
file to disk* 

Finally, realij^e that both textutil and tidy can he 
used with a wildcard diaraeter to process an entire group of 
files, ff all files are in a single directoiy, simply change to that 
directory and: 

textutil -convert html *.doc 
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This will convert all Word documents in the current directory 
into HTML Tiles. To process the current folder and ail 
subfolders, use the find utility; 

find . -naine \*txt -prlntO | xarga -0 textutil -convert 
htmi 

1 opted for xargs over find's exec command to ensure that 
large directories can be processed. You can scrub Word 
metadara in-place using this technique: 

textutil -strip ^convert doc *.doc 
Painless, right? 

Image Manipulation 

While slinging text around may he a common, and very 
specific operation, doing die same to images requires a 
different set of tools. OS X's ^riptable unage ^ocessor «rver 
or, "sips'* is just the ticket. 

like text util, sips leans on frameworks already built 
into the core of OS X. This, of course, lets you do all of die 
great things that you can with a GUI right in a shell! Why is 
this exciting? Aulomalkm, naturally. 

In the past, Tve put together both nightly reports and 
'one-click-bii lids' of documents using both user .submitted and 
random images. The trick is not so much the content, but the 


dimensions of the graphic: you need consistent dimensions so 
you can automate your layout. Resizing graphic files is one of 
the things that sips does best: 

sips -Z 100x100 1MC_1312,JPG out image Usized.jpg 

The “-Z” switch is really nice: it keeps the proportitms of the 
original image, but makes sure neither the width or height 
exceed the dimensions specified. The "-ooG switch writes the 
result to a new file. The image you just made doesn’t have a 
nice preview icon in the Finder? Add one: 

sips -J ItnagG I - sized . jpg 

Oh, you didn’t want a JPEG format file? Convert it at the 
same time using the "-s’* (setPropeity) switch (let's do it all in 
one shot): 

sips Z 100x100 IHG_ni2.JPG 1 -s format ptig - out image- 
sized,png 

71iis one command resizes the graphic, converts the output to 
png and creates the Finder preview icon. Nice. 

For automation, ihtjugh, you often need to find out 
infoniiation about the source before you blindly process it. 
Again, like textutil, sips ha.s function.'^ for this. You can 
dump all of an image's data witii the “-g alP switch and parse 
the output yourself: 
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$ sipB 'g all lMC_13i2.JPG 
/lIsers/eriii/Plcturea/Parade/IMG_1312.JPG 
plxelWidth: 2592 
pixeiHeight; 1944 
typeldentifier: public.jpeg 
format: jpeg 
fomatOptionG: default 
dpiWidth: 180.000 
dplHeight: 180.000 
samplesFerPixel: 3 
bltaPerSantple: 8 
hasAlpha: no 
apace; RGB 

profile: Camera RGB Profile 
creation; 2007:04:04 17:23:31 
make: Canon 

model: Canon PowerShot S2 IE 

.,,or, you can request one or more of these parameters 
directly: 

$ nips -g plxeiWidth -g pixelHeigbt 
/Unora/ffiarcxak/Pictiiren/Pa rade/IHG_ni2, JPG 
pixelUidth: 2592 
pixelHelght; 1944 

Like textutil, feel free to throw a wildcard at sips, 
or, use the f ind/xargs trick. 


Why? 

So, w[iy go ihrougli this trouble, when you can fire up 
Photoshop and make your changes (and even script ill), or use a 
Word processor to mold your words? Agiiin, automation comes 
to mind. Specifically, auU)maiion with low overliead. Using the 
shell Kxrls, you can run scripts on a server without having a GUI 
or installing an application like Photoshop at all. Combine this 
with some of the technicjties I prusented in April, and you can 
achieve some incredibly complex workflows. 

Even cooler: more and more GUI utilities have .srxne way to 
nin shell jobs, Textmate, tor example, t^an run a selection or entire 
dtxaimeni through a shell UxjI and [ilo]) the Results right back m 
the live document. Even apps that don't liave this Rinctionality 
built in can usually he Inked thanks to AppleScript. Take MaiLapp, 
for irLstance. It lets yr>u create signatures, but not dynamic 
.signatures dial rely on a running process. What if you wanted to 
include a snapshot from your iSight in your stg^ Script a atpture 
from isightcapture {http://^vvwinfergolocfic.de/hcicks.htInl), run 
it through sips and AppleScript the cx^py and j>asting of into Mail, 

Or, consider a .simpler alternative: youVe installed fortune 
and want a random formne in your sig. A simple Ixish script cxiuld 
be as follows: 

#1/bin/bash 

Tell Hail.iipp io select all and copy to clipboard 
oflascrlpt «MailCopy 
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lell applicatioti "Systen Events" 

tell application ’’Mall’’ to activate 
kf!y stroke using Icotmnand down I 
keystroke "c" using Icnirajjand down! 

end tell 
MlilCopy 

If Write clipboard to file 
pbpaste > /1np/mai1 paste-tmp 

fortune -s )> /tmp/ia^Hpaste.tup 

tejtUitil ’Stdout convert rtf /tmp/naiipaste, trap I pbcopy 

Tell Mail.app to activate and paste in the content g of 
the clipboard 
003script «MailPaute 
tell application "Systeia Events* 

tell application "Mall* to activate 
keystroke "a" using (cojamand down I 
keystroke *v* using Icotsmand downi 

end tell 
MailPaste 


71)is is aclinitteclly a quick hack with absolutely no error 
checking or other nicctie*s. However, if you open up MaiLapp, 
create a new message, pul your c\irsor anywhere in the body 
and nm this, youll get a fortime tagged onto die end of your 
message (it helps if you already have a sig created). Pretty it up 
a bit and you could run it via the GUI via a “.command" file, 
or, wrap it in AppleScript and rtin it from your,script menulet. 
Or, if you're a Qtiick.silver user, don’t ignore the qs shell to<il. 

Of course, the real f>ower lies in integrating other data: 
from the well, from Excel, from a data base... *wiicreveri 

Conclusion 

When venerable shell tools are integrated with the power 
of OS X, the w^orktlow possibilities truly are endles^s. Be 
creative in yoitr ap()licatk)n of scripting tooLs, and you’ll be 
able to solve any firol^lem for your (iient/cinph>yer/self. 
Media of the month: Brendan Benson's new album, 
“Alternative to l*ove". IPs just good, fun pop music, no strings 
attached. 

tJniil next month, keep i h in king of ways to keep the 
work flowing. 

References: 

“Developer Release Note'': 

http://developer apple, com/releasenotes/Cocoa/AppKit,htmi 
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DIY: BIND DNS Server 

How to turn OS X client 
into a full-featured DNS server 


by Ben Greisler 


DNS is important! 


To paraphrase Sieve Ballmer, “DNS! DNSl DNSI” 

What is the “DNS" and why is it so danged important? 
DNS stands for Dcrmain Name Service and it is the methotl of 
translating domain names to IP addresses. Almost every 
aspect of neiwork usage involves stjme level of name 
services and without it problems will ptjp up, sometimes in 
ugly ways. 

In this article, we will assume that you know that you 
need to provide DNS services for your network. 'Fhere are a 
number of ways you can do this including using OS X Server 
which has BIND (Berkeley Internet Name Domain) built in, 
but say you don't want to spend the $500 to $1000 that OS X 
Server will cost? Is there a lower cost way of doing this? If 
you have a spare OS X client machine hanging around, the 
answer is yes. With just a lirtie bit of time and some low-key 
effort, you cm get BIND running 
on almost any OS X client 
machine. 


DNS Server Basics 

A common scenario is that 
you jusi bought a shiny new 
Xserve and in the process of 
setting it up you turn on DNS 

services and pop in a few machmes that ytm need records ftjr. 
Nice and simple. Apple has done a reasonable job of giving 
administrators an easy method to get DNS uj> and running. 
Some people will argue that it is too simple and basic, but ii 
is enough for OjKm Directory to be happy if you are setting 
up an OD master and clients trying u> authenticate against it. 
An issue comes up when y(ju realii^e that bt^sx practice states 


Since OS X client has BIND 
already installed, all we need to 
do is get it running. 


that you should have two DNS servers to provide some 
redundantly. 

The l)asic .steps we will cake are to provide a metliod of 
starting up tlie BIND DNS .server already iti OS X, provide it 
with the proper configurdLit>n and give it some records to work 
with. There are a nuiulxir of files Involved: 

/System/Library/SrartupItems/BIND/BIHD 

/System/Llbrary/Startupltems/BTND/StarttipPsrameters.plist 

/etc/rndc.key 

/etc/named.conf 

/etc/hostconfig 

/va f/named/named.local 

/vat/named/named.ea 

/var/named/localhost.sons 

/var/named/dbJ92.1fr8.234 {this is an example) 

/var/named/^^reifiler♦ org.zone (this la an example) 


Some of tliese files exist and 
will need mcKlification; others will 
need to bt* fniflt from scratch. 
None of ii is hard, and following 
the steps below will get you a 
running DNS server faster and 
ea.sier dian you would expect. 


Getting Started 


In this article, we will be using a machine with OS X 
10.4.9 installed on it. Tlie test domain is greislerorg- Since 
OS X client has BIND already installed, all wc need to do is 
gel it running; it is really ,siraigluforward. The following 
steps will allow BIND to start every time the machine starts 
using a Siartupliem. We will then provide a way to control 
the server. 
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Creating the Startupitem 

Ojx?n up I’erminal or ssh. into ihc machine. I know some 
[^Dple wiU be unhappy willi tliis, but I find that logging in as 
root makes ihing^s a bit easier while setting up the DNS server. 

Create a folder named BIND witliin /System/Library/ 
Startupltems and navigate to it: 

mkdir /System/Llbrary/Stairtupltems/BIND 
cd /System/Library/StartupIterns/BIHD 

Create two files witliin the BIND folder: 

touch BIND 

touch StartupPa rameters. plist 

Open up Ute BIND file in your favorite editor and drop in 
the following text: 

#i /bin/sh 
. /etc/re.common 

If [ "SiDNSSERVERr * ^“YES " 1: then 

ConsoleMessag^e ^Starting Cheap BIND DNS Server’* 

/ u s r / sbl n / ti ajiied 
fl 

Make BIND executable: 
chmod +% BIND 

Open up the StartupParameters.plisi file in your favorite 
editor and drop in the following text; 

1 

Description ^ "Cheap DNS Server"; 

Provides = t"DNS Server"): 

OrdsrPreference “ "None"; 

Messages * 

I 

start ^ "Starting Cheap BIND DNS Server"; 
stop ^ "Stopping Cheap BIND DNS Server"; 
h 

1 

Allow BIND to l>e cofitroUed: 

We now need to make the RNDC (Remote Name Daemon 
Controller) txmfiguraikrn files: 

rndc■confgen a 

Letting OS X know that we want a DNS 
servenr to run; 

open up /etc/hostconfig in your favorite editor and drop 
in the following text: 

DNSSERVEK- YES- 


DNS Zone Files 

With those steps, we have made ourselves a functional 
DNS server all ready to go^ t^ut now we need to give it some 
information on what lo serve. If you fuive access to OS X 
Server, it is an easy job of setting up your eonfigunitions and 
copying over the various zone files. If you don't, you can use 
the following examples as a template and just modify diem with 
ihe appropriate data for your environment. In this article, we 
are using greisler.org in the 192;i 68.254.x range as the example. 

in a niihshell, we need to build a forward zone file that 
converts names to IP addresses, a reverse zone file that converts 
IP addresses to names and then we need to tell the named.coaf 
file that they exist for usage. 

Forward Zone File: 

'lb build the forward zone file, navigate to /var/named and 
make a file ifiat will contain the forwnnl zone infonnation: 

cd /vac/named 

touch greialef.org.sone 

Inside the file build out the zone information you need, 
such as: 


$TTL 86400 

greislg]: ♦org* IN SOA 

naiiieserver.grRifiler.org. admin,greisler.org. ( 




2007010201 

grelsler.otg. 

IN 

3ii 

ih 

Iv 

Ih 

) 

NS 

nsneseever,grelsler.org. 

grtjialer.org. 

IN 


A 

m.l68.2S4.240 

namesstver. grelslc?r .org. 

IN 


A 

192.166.2S4.240 

tefft.|reifilfir.org, 

IN 


A 

192.168.254.22 

dnaiscoul.gr^isler.org. 

IN 


A 

192.168.254.23 

hiitiba,gr€isler,org. 

IN 


A 

192.168.254.24 


Reverse Zone File: 


To l>uild tlie reveme zone file, navigate to /var/named and 
make a file diat will contain the forward zone infonnatkm: 

cd /var/named 
touch db.l92.l6B.254 

Inside the file build out the zone information you need, 
such as: 

$m 86400 

254.168.192.ia-addr.arpe. IN SOA 
nameserver.grelsler.otg, admin,greifiler.org, ( 
2007010203 
3h 
1h 
Iw 
Ih ) 

254.168,192,in addr.arpa. IN NS nau^aexvec.groi^ler.org. 


32 July * 2007 


WWW.IWCTECH.COM 





We can deliver. 



Mac 


Universal 


Our technical expertise spans the entire spectrum of software development, including Mac and Windows 
applications, system-level programming, cross-platform design, handheld and wireless platforms, gaming, 
web development, and everything in between. We offer comprehensive development 



ervices including project management, software design, implementation, and quality assurance. Our work 
icludes commercial projects for worldwide external release, applications for vertical markets, and custom intra- 
ompany enterprise software applications. Check us out at www.criticalpath.com | info@criticalpath.com 



aOWi QfttKifif PWh SonwafH frK. W trademarks am rtic pmportv thnir owfwtn 














Eaiy^D 


Make Drawing Fun on 


Technical Drawings 

Illustrations 
Charts & Diagrams 
Text Layout 
Web Graphics 
"This Advertisement" 


EazyDraw is a well 
balanced 2D vector 
drawing application, 
not bloated with 
obscure computer 
illustration 

procedures. The new 
OS X user interface 
stays out of the way 
and lets you get your 
ideas on paper * or 
the web. 




Import & Edit 


MacDraw 
ClarisDraw 
PICT & PDF 



http ://www. Eazy Dra w.com 


Phone: 608 444 5245 
Fax: 608 635 2124 

N 5040 Beach Garden Road 
Poynette, Wisconsin, U.S. 53955 

Resellers Call Jay: 608 469 8991 


340.2H J6B. 19?.. In-addr.arpa. IN 
22.254.163.192.in-addr,ariMt, IN 
23.2i4J68.l92.in‘addr.arpa, IH 
24.254.16B.192.in-addr.arpa. IK 


PTR naieserver.jrciBler.org. 
PTR tefit.jrElaler.org. 

PTR dnsistool.grcislet.erg. 

PTR bijbba.greisler.org. 


Modifying named.conf 


To allow tlie DNS lo rcco^'nize those zones, we need to 
tell /etc/named.conf about tlie zone Files by editing 
/ete/natned.coiiF and placing the following text within it: 

zone "greisler.org" 1 
type roafJter: 

file "/var/named/greisler.org. zone" : 

); 

zone "254.168.192.In addr.arpa" IN [ 
file "db. 192.168,254": 
type master: 
h 


Testing the DNS Server: 

Kesian tlie compuicr ;ind test the DNS server: 

nameservor:^ backupS hofit -a dnEiacool 
Trying "dnsiscool.greisler,org" 

-»}\m}m« opcode: QUERY, atatua: NDEKHOR, Id: 52764 
;; flags: qr aa rd ra: QUERY: 1, ANSWER: 1. AUTHORITY: 1. 
ADDITIONAL: 1 

QUESTION SECTION: 


: dti s 1 scool. g rei B ler. or g. 


IN 

ANY 

ANSWER .SECTION: 
dttslscool.greisler.org. 86400 

IN 

A 

192.163.254.23 

:: AUTHORITY SECTION: 
greielet.org. 86400 

IN 

NS 

nameserver. grelsler. erg. 

:: ADDITIOHAI. SECTION: 
nameserver,greasier,arg.86400 

!N 

A 

192.168,254.240 


Received 97 bytes from 192.168.254.240#S3 in 18 ms 


Wc can see froiTi this example wc have asked for the A 
records kn diisiscool.greislerairg anti i\ returned in the answer 
section tliat its IP addres.s is 192.168.254.23, w^hich is wliat we 
expected. We can try this for the i^l'K or rever.se look up records: 

name^etver:" backupS hoot a 192.168,254,23 
Trying "23.254.168.192,in addr.arpa" 

:: -»HE/U3ER<< opcode: QUERY, status■ NOERHOR, id: 21546 
;j flags: qr aa rd ra: QUERY: 1, ANSWER: 1, AUTHORITY: 1. 
ADDITIONAL: 1 

:: QUESTION SECTION: 

121.254,168.192.in^addr.arpa. IN FTR 

:: ANSWER SECTION: 

23.254.168.192.in-addr.arpa. S64O0 tN PTR dnsiscoal.greisier.or|, 

;* AUTHORITY SECTKHI: 

234.168,192.ih-addr.arpa, 86400 IN NS nanascrvcr.grei.-Jler.org. 

:: ADDITIONAL SECTION: 

naaeaerver.grelstor.org, 86400 IN A 192.168,254.240 

Received 122 byieB from 192.168.254,240#53 in 2 dei 
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We asked for the PTR record for 19Z168.254.23 and ii 
reiLirned in the answer section, dnstscool.greisler.oi^. Success! 

Understanding Zone Files 

There are many gocKi references on flow to l>uild a zone 
file, hut 1 fincl that the easiest way to get started is to look at 
an existing file and to unden>Uind witat Ls in it. We have the 
sample zone files earlier in the article, so lers dissect them 
and see what we find. 


The first line give.s us the I'll or Time To Live. This is how 
long cached data will live on your DNS .server. 

I'he second line includes the SOA or Start Of Authority. 
4'his tells us that this 'nameseiver' is authoritative for this 
domain. The portion that has admin.greislerorg declares the 
email addre.ss of the zone contact. Notice it doesn't use rlie 
standard email fonnat we are normally used to 
(odmin@greisler.org ); It simply replaces w itfi a dot. 

The following section is slightly rtuxJified fri>in the earlier 
examples as 1 have added notations for the definitions of eat'h 

line. ITie data in this section is 


Forward Zone: H'j g |q| easier 

A forward DNS recoal is called 

an “A'’ record, Tliis is ihe (ypc‘ of to remember '3rdfloorprinter' 

rec'ord that mighl get used when 

you enter a URL into a browser and than 112.16.23.192.’ 

the DNS system needs to find its _ 

associated IP address. Our s;iiiiple 


mostly for use with slave DNS 
servers anti doesn’t impact us ai 
the moment, I’he serial number Ls 
exactly that; it allows us to 
scTiaJize the zone file for whatever 
usage we may want. In this case, 
it is the date the zone was made, 
Tlie 8^'^ line tells us which 


forw'ard zone file is located ii 

$m 86400 
grelsler,org, IN 
nsmeserver.greialer,org* 


gtelBler.otg, IH NS 

grdGUr,org, IN A 

naroeserver.Breialcr.or^. TN 
test,grelfii£r.otg. IN A 

dneiscot)l*grelsl<?r,Ofg, IN 
buhbji.greisler.org. IN A 


/var/named and kK>ks like this: 


SOA 

admin. greisler^org, ( 
20070i0201: serial 
Ih : refresh 

Ih : retry 

Iw : expiry 

Ih ) : minimiiii 

nameserver,grel$ler,org. 
m.ihnM.iho 
A 192,160,254.240 
192,168.254,22 
A 192,168,254.23 

192,168,254,24 


DNS .server Ls authoritative for the zone. We only have one 
listed in ihls example, but we typically would list two or more 
depending on the size of the environment. 

The following lines include the actual information 
regarding the retxirds we want to absolve. Kor example if the 
server “bul>l)a.greis]er.oig" had the IP of 192.168.254.24, we 
w rite it t}Ut as: 

biibba.greisler.org, IN A ] 92,168,254,24 

Note that there is a tailing dot alter the ,servcT name Be 
careful with your dots and make sure they are in die right 
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places. ITI: means Internet and is the class of record. Tlie 

**A'’ meaas address, 

Reverse Zone: 

'Hie reverse zone allows the DNS server to resolve IP 
addresses into host natnes. In tlie OS X server world, without 
rcven^* kK)kups niaiiy things will fail badly, soch as a login to 
Open Directory, A reverse record is kncwn as a pointer record 
or PTli. Ijet's kK>k at otir example: 


$m S6A0O 

254,168,192,10 addr,arpa, IM SOA 

naraes^rver ,greisl er, org. admin.greiKler.org. ( 


2H. BS. la- addr. a rpa. 

2D07010203 

3h 

Ih 

1w 

Ih ) 

tN NS 

nfl ne.ie r ve r. uri* 1 s 1 pr. 0 rg. 

addr.arpa. 

IN 

m 

naseserver.greislei.ori. 

12.2)4.U9J97.in addr.arpa. 

IH 

m 

te*r.gr©fsli?r,c»rf^. 

11.254.161.192.in ^dr.arpa. 

IN 

m 


34.254.163.192,in-Addr.arpa. 

IN 

PTl! 

bubba,greltter,or g. 


Most of the infnmiation from the forward zone is the same 
or similar to the reverse zone except llial we define ifie tP 
address first. Yr>u might have noticed that the addresses are 
listed in reverse order and have “.in-addrarpa,” tagged onto 
them; this is the correct formatting. Also, note the trailing dot 
after each host name. 


The /etc/namedx'onf file: 

Hie /etc/mimed.coni' file contains the configuration 
information for the 'named’ daemon. What was important to 
us was to enter the informaLion for tlic new zones, forward 
and reverse, dial we made and make ‘named’ aware of them. 
In the extimpie iDeJow you will see die entries dial begin with 
“zone’' and how they point at the “zone file" files in 
/var/ named. 

You will see zone file entries for named.ca, 
locitlhost.zone and namedJocal. The namedxa file holds the 
DNS root server information. These are the official top-level 
DNS servers of the liierarcliical DNS search process. 'Hie other 
two files provide local information, which is consistent on all 
machines. Basically, it defines what “localhost” and 
“127.0.0. r are. 

The file also contains information regarding whal gets 
logged and where it gets logged. Hiis may lie imptjrtant if 
you have a non-standard place you like to have die logs 
located. You can choose different levels of lagging including: 
info, debug, notice, warning, error, criik'al, alert and emerg. 

// 

// include keys file 
// 

include "/etc/rridc,key”j 

// Declares cotitrul ciJEiniiels Lo be ursod by the rndc 
in lllty, 

// 

// It is recennmended that 127,0.0.1 be the only address 
used. 

fi This also all owe non - privileged user a on the local host 
to manage 

// your name ijcrver, 

// 

// Default controls 
// 

controls I 

inet 127,0,0.1 port 54 allow lany;l 
keys I "rndc-key*: I: 
h 

options t 

directory "/var/named": 

’ If there is a firewall between you and 
naraessrvecs you want 

* to talk to. you might need to uncommeTit the 
query-source 

* directive below. Previous versions of BIND 
always asked 

* questions using port 53, but BIND B.l uses an 
unprivileged 

port, by default. 

V 

li query-source address * port 53: 

I: 

fi 

li a caching only nameserver conflg 
// 

zone IW I 

type hint: 
file "naiaed.ca": 

I: 
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IMS have given you the tools to 
hnihl a DNS sener. You eon now 
use this sorvor as a spare, a test 
hod for configurations or anything 
elseyoucanthinhof. 

zone '"iocalhofit" IN I 
type master: 
f ile ” 1 ocal ha a t. j: on b ’*: 
allow-update f none: t; 

I: 

zone ’^ 0 . 0 J 27 .ln-addr.arpa* IN ( 
type tuaster: 
file "named .1 oca J**: 
allow-update I none; I: 

I: 

zone "grelsler.org" I 
type oasterr 

file "/var/namod/greislec.org.zone": 
h 

zone "234Ja8.192Jn-addr.arpa* IN t 
file "dbJ92.L68.234*: 
type master; 

I : 

loggitig I 

category default I 

_default_log: 

I; 

channel _default_log I 

file "/Library/Logs/named Jog": 
severity info: 
print-tile yes: 
h 
J: 

Conclusion 

Ttiere is Jiiiidi mone to utilizing DNS itself, but we kive given 
you die UKils U> build a DNS server. You can now use diis server 
m a sptire, a test Ixxl for configuraLic>n.s or anydiing else you can 
diink of. 

A common use of DNS within a network is to refer to devices 
Sfxxific to our nctwtirk, sucli as file servers. We can also put in 
entries for IP printers, individual workstations or anytliing dial has 
an fP addre-ss. It Is a lot easier to remember ^^rdfloorprinter'’ ciian 
“172,16.23J92," It is also handy to have people hitting your email 
server by its mtemal adda^s ratlier ditm Imving to go ouLsidc die 
network only for it to come back in. 

There aa many refeances to ase when dealing with DNS. 
ITie .standard reference seems to Ixr the Liu and Albitz fxx>k, 
DNS and BIND. It is a great bexjk that requires some effort to gel 
ilirough, (nil .seems to do its (>est answering specific questions. 
It isn't something tliat you would sit clown and read from front 
page to back at one shot, but it's content is top notch. 

MACnCH 


When doing web searches for infoniialion on BIND, it is gtxxl 
to know wltiit version you are ainning. 'Itie latest version of OS X 
at the lime this article was written was 9.3*2. You cm chet^k yours 
by typing in coiiamnd line "'named and it will return die 
versbn: 

nameserver:'* baakup$ named -v 
BIND 9JJ 

Make sure you peruse the man pages ft>r the following: 
named 

named.Cdnf 
rndc 

rndc.eatif 
tndc con£gen 

Gather your resouR’es and newly minted DNfi server and 
have ai it. DNS .server management is a skill that is rewarded 
with smcHithly running .syslcms. 

\\\\ 
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The Road to Code 


by Dave Dribin 

The Courage 
to Start 

Take the first step towards 
^programming for Mac OS 

Welcome 

Welcome to Tile Hniid to Cbc/e^ new column uliout 
proj^nimmin^ on OS X for ihe non-prognimmcr My name is 
Dave Dribin, and i'll l>e yonr guide in the Lssues to come. 
Unlike a rollercoasier, playing around canT hud you. In fact, 
the best way to learn programming is lo actually do it. So 
please, keep your hands and fingers on the keyboard al all 
times. 


nuinlx-T of prognuiLS I WTOte in Applesoft BASIC; a program to 
keep track of my (measly) bank account, a blackjack game, and 
even a program to keep trac k of my (fowling strcjres. Wfiile die 
finance software and blackjack are nol groundlireaking ideas, 
the Ixjwling program was fairly unique. At the end of our 
bowling league season, we would get a printoui with all of our 
scores for the entire year, along with a ton of statistics. I was a 
liowling geek and loved these stats, but I didn't want to wait 
until the end of the year to see them. ,So, I wrote a program tliat 
wtiuld allow me to enter my scores and provide the same 
statistics without the wait. 

There are a couple of lessons to lake away from this. First, 
start small. I didn't dive riglil into writing my liowling program, 

1 also found plenty of half-finished work and small, 
experimental programs on my old disks. Second, practice, 
practice, praaice. The mr>re f programmttl, the Ix^tier 1 got. 
Hven the 1 title programs iliai dcm’i do much add to your 
exjierience, and that counts for stirnething. 

A lot has changed since the ckiys of the Apple 11, with its 1 
mc^^henz prcKX‘ssor, 6*1 kikhyics of memory, and 140 ki/obyte 
flopfiy disks, but the reasons to start programming have not. 
Mayix^ you want to write a program that adually w'orks the way 
you do, maybe you want to write the next blockbuster game, 
or [naylic you just think it’s ftin, These are the reasons why 1 
began progrtimming and why 1 still program today. Whatever 
your reasons, you shoiiltl sian , loo. 


Why Program 


What Is Software 


Before I go into the details of prognimming, you might lx» 
w'ondering w'hy you would want lo program a computer. As a 
computer user, you no doubt know^ that the computer is im 
personal assistant. It helps us stay organized, 
eases coinmuniciiiion with others, and 
entertains us. Unforiiinately, you migfit al.so 
agree tiiai a computer doesn’t always work the 
w^ay we expect. Sometimes a piece of fH)ftware 
allows you to do evcrytliing except that one 
thing you need it to do. Other times, software 
last dtx^sn't exist for the task you are trying to 
acctanplish. The key to harne.ssing the full 
pcjwer of your jx^rsonal assistant is to .speak to 
it directly by writing your own prngnim.s. 

I lx?gan programming a long time ago on 
an OjXTating system far, far away. Apple's 
DOfi 3.5, to lx exact, running on an Apple lt+. 

Once 1 started programming, 1 was hooketi. 

Tire fact that I could tell die etimputcr wliai to 
do and it would listen was fantastic. My first 
prognims were very simple, but over the next 
few years, the pnigrams I wmte increased in 
complexity. 

A year ago, 1 was going through some of 
my old 5.25" floppy disks. 1 came across a 


Software, also known as a progntm, is wliat controls a 
ctHuputer. A computer's sole puqx>se is to respond to 
iastTUtiions from a prognim. By writing programs ft)r the 
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Figure 1: My Apple ][ bowling program 
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computer, you can take full control of your personal assistant. 
Tltink of a program as a series of instnictions, like a reci|x;, tlial 
the computer follows, step by step. Bur sometimes even a 
programmer has trouble communicating witli the compitter It 
is very literal in its inter|:jretation of these instructions. If you 
don’t give them properly, the computer may go off and do 
something uncx|KX.1ed. 

’I’he language used to write programs Ls called, l>race 
yourst'li' for this, a prognimminf^ bnguiige. Actually, computers 
arc muhUinguaf Some of ilie prognimming languages available 
on Mac QS X iO.4 are C, C++, Ruby, Rytlion, and 1 *ctL Each 
language has its own pros and cons. However, the language 
Apple recommends for writing new OS X software is called 
Objective-C. Since in this case it’s wise to IV>llow the 
mothership, Objeciive-C will be the main focus of this column, 
Ol>jcc:tive-C is art extensi<m to C with support for object- 
oriented programming. You’ll gel to learn atxiul Objective-C 
and fancy phrases like ‘"objectc^riented programming" in due 
time, but First we need to build a strong foundation. Since 
Objective-C is l>uilt up^)n C, I'll cover the basics of C liefore 
moving on to Objective-C. As the old saying goes, youVe got 
to learn to walk before you can run. 

Time to Code 

Before starling lo write our first program and in order to 
follow along, you will need to install Xcode, Applets free 
development environment. As of tliis writing, the current 
version of Xctxle is 2,4.1. It requires Mac OS X 10.4, and is 
available from A|^ple's deveioper welxsitc: 

http://developer.apple.com/toois/xcode/ 

You will need to become an Apple Developer 
Connection (ADC) iueml>er, but it d<x;s not cost anything to 
register. Xcode includes all the tools to write Objective-C, 
including a text editor and a compiler. Even though 
Objeciive-C is die language we will lie communrcating to the 
computer with, the computers processor doc.s not 
understand this language directly. A compiler is needed to 
translate Objcctivc-C into a.s,semhly code, which is the inie 
native tongue of the processor. 

With Xcode installed, we can finally start getting our 
hands dirty and begin coding. We Ye going to .start with wkitY 
called a "Hello WorW program. This "Hello Workr program 
will prim a nice greeting to the user when run, and is often 
used to introduce programmers lo a new language. A word of 
warning: "Hello World’’ isn’t sexy. In fact, it doesn’t even use 
windows or the mouse. WeYe going to crawl back into the 
dark ages for a bit, and well Ix! creating console applications, 
not application,s with a graphical user interface (GUI), until we 
get through the basics. While console applications will run 
directly in Xccxle, they ran also be Rin from the command line 
using Temiinal. But don't get discouraged. We will get to GUI 
applications soon enough. 


Creating Hello World 

To create our first program, slanufi Xcode and select New 
Project... from the File menu. Xcode provides starling point 
templates for many kintls of projeas. ’Hie one we ate looking 
for is Standard Tool yrider Command Line Utility. For a projea 
name, cho<\se hello^world and choase a suiia[)le directory, sucti 
a.s -'/work/hello_word. After clicking Finish, Xcode will 
cmate die project, along wilh some basic files. LLse Figure 2 and 
f'igure 3 as examples. 



Figure 2; Creating a new Standard Tool project 
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Figure 3: Setting the project name and directory 

C programs are made up of one or more text files with 
the “x" extension called source J3es, A source file contains 
the actual programming instnictions called source axle, often 
just .slionened to .source or code depending on the context. 
I’his is also why progni/nmjVig is sometimes referred lo as 
ccKiing lEclitor s note: if iliey can be called programmers or 
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L’txlcrH, cuuld they also )>e referred to as sorcerersl' * jrl. As 
part of the New Project template, Xcode rrcaled a single 
source file named main.c. To view this file, expand the 
Source item in the left pane, and select the main.c item. 
Next, click on the Editor toolbar icon. Your window should 
look similar to Figure 4^ 


You will notice that this file is not emj>ty. As it turns out, 
Xcode creates a ready-to-run ^^llello World" every time we 
create a new profect, 'litis is handy tor us l^ecause it means we 
don’t even need to type anything lo get sumed. Click on die 
Build and Go t(K>ll>ar icon to compile and run the program. If 
all goes w^eil, you should gel a Run Log window with the Hello, 
World! message on line 2 similar to Figure 5. 
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int main (tnt orge, const char • orgvt]) { 

// inssrt code 
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reiuTT* 0; 
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Figure 5: Hello World Run Log 


0 Succeedef 

Figure 4: main.c source file in Xcode 


Let’s start picking this program apart line by line. The 
programming instructions are listed in the order you want them 
to execute. You can think of these instructions, called 
.sraremenrs, as sentences, except insteatl of u,sing a period to 
mark ihe end of a .senlence, C uses a semict>loa to mark the end 
of a statement. Not every line contains executable statements, 
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ihoui^li. Sonietinie.s, the code contains extra informaiion ulK)irt 
the program for the compiler, and oUier times it contains extm 
information for the prtjgmmnier For exximple, line 4 starts with 
two slashes, and is what is called a commt^nL Ttie compiler 
ignores the two slashes and any text after them You can put 
whatever you want in comments, but they should used to 
make the [program more understandable for stimeone rc'-ading 
tlte program. 

On line 5, you liave a statement that looks like; 

printf ; 

This is what is known as a funciion ailL A function in C is 
a set of statements iluit tun be reused over and over again. A 
function call executes the function's statements. When I he 
function finishes, the program picks up where it left off before 
the fund km call 

In this function call, printf is die name of the runction 
to exeaite, and the text between the j>arentlicses is tlie 
function's atgumenls. Aigumenis are used as inputs to the 
fimc:tit)n allowing you to customize how it behaves. Tlie text 
Ix^lween the double quotes is ailled a string. The printf 
function is pari of the Standard C library, and displays a 
message to the console. It expects a string argument ant! uses 
that siring as its message. 

First Steps 

To get a better understanding, let's nn>dify lliis program a 
bit. Change this line of code to: 


printf("Ky favorite number is Xd\n"* 7): 

Now build and run tiie program, and the output in the Run 
Log should show: 

My favorite number is 7 

Now its getting interesting. 'I'his time we pa.ssed two 
arguments to printf, the first a string, and die second a 
number. Yotlll notice tliat instead of printing %d, it replaced 
that widi 7. Tliis is where die part of printf name comes 
from; formatted printing. 1he string passed to printf is called 
a format string, and is used like a template to fomiiit the final 
message. In die example above, Id is a placeholder for an 
integer numlx^r. An integer is a numter without decimal points. 
Format strings could be a topic in iLself, l)ut lierc is another 
example showing how to use strings and floating point 
numbers (numl>ei:s w/f/i a decimal point): 

printf("Hello XB.\nMy lunch cost "Dave** 

7,5): 

llie output of this is; 

Hello Dave, 

Hy lunch cost $7*50. 

You can see the %s is replaced witii tlie string Dave and 
the %. 2f is replaced witli 7*50. I'his also shows liow you can 
customize the formatted output. The *2 tells printf to always 
use 2 places after the decimal point. The final piece of magic 
going on Is the string \n. printf replaces this string with a 
newline, which is wliy our output shows up on two lines. You 
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alriKxst always want one of these at the end of your tbrmat 
siring, but 1 wanted to show explicidy what \n docs and that 
you can pm them anywhere in your string* 

Congratulations! You're now programitimg! Try replacing 
the string "Dave" with your own name, and try printing out 
other numbers. Kemember, it helps to exiKTtment. 

Variables 

Variables arc the next key concept to iinderstaml. Ihink of 
variables as containers that hold stiilT, like storage boxes that 
you may have around the house* The.se Ixjxes can hold 
different items, such as ixxjks and clothes. In order to keep 
tilings organized, your IxDxes may also have lalxtls, like 
"Science Fiction"^ so you know what it contains. Similarly, 
variables can hold dilTerent valu^, such as numliers and strings 
and they also have laiiels to help keep things organized. Ijet's 
replace the entire main.c of our earlier prognim with Listing 
I. 

Listing 1: main.c demonstrating variables 

jfinclude <Btdio.h^ 

Irit wjaintint aCRC, tmet char ^ argv[i) 

I 

int myVariable; 

myVariable 5 i 

printft”The number lis XtUrC* myVariahle): 

myVarlable - tnyVariable*2; 

printf("Ths number is now tnyVariabla): 

return 0 : 

I 

In C, every varialile must he declared before it's used, so 
the ctHTipiler is aware of tl. The statement on line 3 is calletl 
a vumhle ihchtniriot}, and it tells the com|>iler the variable's 
lalxd, Hilled a name, and Lyjx!. This variable is named 
myVariable and its type is int, for an integer. Why do we 
need the type? Back to the box analogy, vanal>les in C arc 
like boxes with strict rules. Boxes tliai are designed to hold 
iKioks cannot hold clothes, and Ixixes designed to h<iUl 
clothes cannot hold hooks. I'hus. an integer variable can liokl 
any integer, hut not any other lype, suclr a.s floating point 
numbers or .strings. This may seem silly, but one benefit to 
including the type with every variable is ii allows the 
compiler to lell you when ytm’ve made a luistakc. Just as 
your parents will tell yr^u if you are putting your books in 
your clolhes box and make you fix it, the compiler will not 
let you put a string in an integer variable. 

You tun t:hange the contents of a varialile with an 
assignment slutemmi using an equal sign. iTie first assignment 
statement sets the contents of the variable, myVariable, ity 
five* The second assignment statement shows that you can u*se 
a mathematical expression on the right hand side of the equal 
sign. In this case the asterisk (also called a star) means we are 
multiplying the original number in myVariable, five, !>y tw'o* 
The resulUng output of this program is: 


The number is 5 
The number is nm J€ 

A Brief Interlude on Expri^ssions 

You can tisc any of the common arithmetic operations 
summarized in Table 1 as pan of a mathematical expression, 
and you can use parenthesis to prioritize multiple operaiiorLS* 
lake this expression, as an example: 

inyVariable - EmyVariable+l) ; 

First, one is added to myVariable and then the result is 
multiplied it by two* If myVariable starts off as five, it will l>e 
set to twelve by this statement. Without parenihesis, the 
stantlard operacor priority is observed. In this case, one is 
multiplied by two first, and then the result is added to 
myVariable resulting in myVariable l^eing set to seven. IFs 
usually a good idea to adcl parenthe.ses u> any complex 
expression to avoid confusion* 

Table 1: Arithmetic Operations By Priority 

Operatk>ii C Syntax 

Multiply * 

Divide / 

Add F 

.Subtract 

Variety is the Spice of Life 

Variables are an exireincly imfXjnant part of nor only C 
programming, but al.so any prf>gnimming language. Now that 
you know' the basics of variables, try changing tlie name of 
myVariable lo something else or adding new variables. Also, 
try otJl difl'crenl malhematical expressions* Keep in mind that 
variable names have certain restritiion.s. You may only use 
letters, numbers or the imdersctire cftaracter and they 

must not iK^gin with a numlxx 

Your Own Functions 

'Ihe Standard C library Ciinrains other funeiioas Ix’sides 
printf , but as your piTograni .siaits gelling laiger, you will want to 
write yoiirowji t:u*stoiTi functions. Ustially this is Ixc'au.se you want 
to use ilie same code without dupliciting it. hut sometimes you will 
use functions to make your pnigrams easier lo understand. Let’s say 
tliat we will lx priming our Hello, World! mess^ige multiple 
limes. We can put this code in our own Rinaion, and then cill it 
multiple times, Mtxlify' main*c to match Listing 3. 

Listing 3: mainx demonstrating custom 
functions 

itinclude <atdlo*h> 

void prlfitHessa^^Cvold) 
t 

printft"hello. World)\n”); 


4f> July • 2007 


WWW.MACTECH.COM 






Instant compatibility. 



Run Windows' on your Mac 
- without having to reboot. 


"It's like having two computers in one, the best of both worlds". 

- Walt Mossberg, Wail Street Journal 


Parallels™ Desktop for Mac is the award-winning 
virtualization software that lets you run any combination 
of operating systems side-by-side with OS X on any 
Intel-based Mac system. Take advantage of Windows-only 
business-critical software, such as Outlook™ and 
SQL Server™, without giving up the security and reliability 
of your Mac. With the Coherence™ feature, you can even 
launch and run Windows applications directly from your 
OS X desktop. 



Macworld 


OF SHOW 





coparallels. 


For more information about Parallels™ Desktop for Mac, please visit parallels.com or call us at 1-425 282-6504. 


















































• Measure 2.4,5 & 5.7 GHz bands 

• Demodulate All 802.11 b/a/g/h packets 

• User Selectable Power Triggers 

• W.I.S.P. Antenna Alignment 

• Multipath, MAC, SSID & Absolute Channel 

• MAC Security Autborization Lists 

• Interference Mapping Software (optional) 

• RF Direction Finding (optional antenna) 



ipedrurn 

i&n any 1A or i GWz neh*orL 


wMrwrw piaH AP rowrag* 
’ JPaerphirr CPS 


Berkeuy 

Varitrohics 

Systems 

732-548-3737 


Serving fhe 
wireless industry 
for 25 yeors. 


www.bvsystems.com 


return; 

1 

int Biaindnt argc, cm&t th^v * argv[J) 

I 

prlntTfessage(); 
prlntHessageO : 
return 0; 

t 

If you build and niii this progmm, you .should see inir 
mcs,sage printed twiee: 


Hello. Worldl 
Hello. World! 

Notice tliiii we ty^ied our function liefore using it - it 
precedes its use in the program, llib is called chtming a 
hincfion. Like variables, you must always fell the compiler alxiut 
die function aliead of lime. Tlie very first line of a function is 
aillc^l a function signature. The function signature specifies the 
name of the hinction, the name and tyjie of each argumenL and 
the type of the return value. Ijet^s look a! our function signature: 

void printM^ssagotvoid) 

Our ftinction name is printMessage. It doe.snt take any 
liigumenis, so wc use (void) to sy>eeify iJiis. Tlie first void 
Ix'fore tile function name means our function does not have a 
return value. We will gel more into arguments and return 
valuers in a bii. 

After the function signature comes the function Ixjdy. The 
function body always begins and ends with curly liraces, { and 
}. Inside the braces are the function's statements. The iKxly of 
tile printMessage function contains two statements. The first 
calls another function, printf. And the second is a return 
statement. A return statement marks the end of a function, 
and causes the program U> return to the place where the 
function was called. While you may include statements after the 
return statement, they won't gel executed. Ibe return 
statement is optional for funciions without a return value, so 
we could have written this fiinclion with one statement as: 

void printMessage(void) 

[ 

printf("Hello, World An"); 

) 


Arguments and Return Values 

As I mentioned earlier, functions may have arguments and 
return values to customize their behavior, similar to a 
mathematical ftinction. Modify main.c to match Listing 5- 

listing 5: mamx demonstrating function 
arguments and return values 

finclude <stdio.h> 

Int sqtiareNiunber(int number) 
f 

Int f^quare: 

square = number*number: 
return square; 
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Ini main(int argc. char * argv[l) 

( 

iat nimber; 

ntinthar ^ St 

printf('*ThB tiunibar is %d\ti"* number); 

number fi q ua r eWumbe r (numb e r) i 

printfi^Tbe number is iioi« XdAn'** tuimber); 

return Oi 

} 

If you build and run this proj^rani, you should get the 
output; 

The number Is 5 
The number is now 25 

'llie ftinciion sigiiature of the squareNumber function is 
different from the printMessage function in that the return 
type has changed from void to int, and the argimients have 
changed from (void) to (int number), lliis states that our 
function expects to take one integer atgumcni and return an 
integer value. Inside the body of 
our function, we mull iply die 
numlxT by itself and store diis 
resuli in a new integer variable 
called square. Ibis time, die 
return statement itself takes 
an argument* wliich is used as 
die return value. 

Ijocal Scope of 
Function Variables 

Function tirgumcoLs themselves are variable.s. Thus, instead 
of creating a new variable* we could have shortened oui' 
function to; 

int equareNuinber(int number) 

( 

number ^ number*number; 

return number; 

J 

Notice that even though we are changing the number 
variable in the squareNumber function, we still have to set 
die number variaiile in the main function. Tliis is because each 
function has it’s own set of variables tliat are independent from 
other funaions. Variables dcHned in a function are called UkhI 
vitmhhs. IjOc:al variables are only available for use iaside the 
funciion diey are declared in and do not conflict with variables 
defined in another function. Tliey are essentially different boxes 
that just happen to liave the same label. ITie ciortcepl of which 
variables are available is allied varktbh :>coping. We will cover 
tnore alxiut variable scaping over time. 

As ii luras out, we don't even have to bother using die 
number argument as a variable. We can just do the 
multipliaition directly in the return statement; 

squareNumbertiut number) 


return nmriher * number j 

I 

Multiple Arguments 

Kunction.s may lake more than one argument by separating 
each one widi a comma; 

int niiltiplyNumberstint nuniberl, int numberZ) 
t 

return numberl^number2; 

I 

This states that you must pass two arguments when calling 
multiplyNumbers, for example: 

number = multiplyNumbers{number, 3): 

Now that you know^ how to define your own furtciioas, ids 
time again to cxjx*riment. If you are writing your own fiinctions, 
keep in mind that the same restrictions descril3ed above for 
variable names also apply to funaion names. Try tTcaling a 
function that Lakes three floating-point number arguments and 

returns the average of them. I'll 
give you a hint, especially since 
1 haven't mem toned how to 
specily doating point number 
variables and return values, yet. 
Here’s a funaion signature: 

float threeKutiiberAverage{float 
nurabarl, float number2, float 
numberl) 

Notice that I used float 
as type for ilic aiguments and 
return value. 'Fry and fill tn lire function !xx!y yourself. 

Tying Up Loose Ends 

Before wrapping up, \ want to cover a couple points IVe 
l^een .skirting around. Now tliat you know how to define 
hmcticjns, you’ll notice that weVe actually liccn defining iwo 
functioas in the last few example,s. Tiie second funefion is 
named main, and main is a special function. The operating 
system a/ways calls main when a C program starts executing, 
and is called the entry' pf>/nf of your prtjgram. You1l notice that 
the signature for main has two arguments and a return value. 
The arguments use somewhat advanced types like an array of 
strings* which you can ignore for now. Tlie integer reairn value 
is sent to the operating system when your program exits. The 
operating system then sends this value to the program that 
started your progmm. I^'or example, if you change the return 
value to something ttther than zero, you will see this reflecied 
in the Xaide Run Log window as the status. Be careful, 
though. Reluming a numlier other than zero from main is 
typically used to indicate that sometliing in your program went 
wrong. 1 suggest always returning zero, for now. 

The second point iVe skirted around is the very first line 
of every example: 

l^includ^ <stdio.b> 


It doesni hurt n eiperlrnem. 
Voull prohably mu into problems, 
bmihars all part 
of the learniog process. 


50 July • 2007 


WWW.MACnCH.COM 








DOCKING STATIONS FOR APPLE COMPUTERS 



Convert your MacBook Pro®, Mac Book®, Power Book®, or iBook® 
into a desktop in seconds without misplacing cables or damaging connectors 


• Aluminuni Plate helps in cooling of notebook 

• Connectors are routed to rear of Dock 

• MagSafe® Housing prevents 
accidental disconnect 


Also available in Black • Built in DVI/VGA full size 
5 USB 2.0 compliant ports • Gigabit Ethernet Rj45 

(4 port powored or unpowered hub, 

AC/DC adapter included) 


17” 

MacBook® Pro 
Docking Station 


13.3” M 
MacBook®^ 
Docking Station 


15.4” 

MacBook® Pro 
Docking Station 


PowerBook® G4 
Docking Station 


PowerBook® ' 
Docking Station 


iBook® ■ 
G3/G4 Models 
Docking Station 


PowerBook® G4 
Docking Station 


Visit our website for latest product announcement www.BookEndzdocks.coni 










Reii^e!nl:)er how I said that all funatons must be defined 
tobre usd* Well you may ])e wondering why we can call printf 
witlioLii a defimtion, Tills first line tells the compiler to include 
anotlier source file named stdio.h. Tills .source file, wliich is 
short tor ‘'standird input and output”, contains tiie definitions for all 
of the Standard C iibmry functions diat pertain to input and output. 
Notice diat diis source file has a “.h” extension irLstead of Tills 
is a special source file cjtlled a liankrlilc. We w'ill lie learning more 
about header files, liut for now, you need to remember to have tliis 
line in your source files, if you plan to iLse printf. 

Conclusion 

Phew! You made it through this fii-si article, and you've 
already learned a lot alx>ut C programming. I'll reiterate what I 
.said alK)ui practice. Take what you’ve learned alxiut functions 
and variables and see wliat you can dth It doesn't hurt to 
experiment. You’ll probably run into problems, but that’s all 
part of the learning process. 

Learning something new can lx? (werwhcltuing. 1 staned 
running a couple years ago, after being mainly inactive my 
entire adult life. When 1 was getting started, 1 read an 
inspirational liook called 77ie Connie To Stan, l>y Jtihn 'The 
Penguin" Bingham (Bingham 1999L A key (xhut John makes is 
that the hardest part alK)ut starting to run at the age of forty- 
three is taking the first step. This advice holds true lo learning 
anything new, no matter what your age is, though. Don’t let 


that first step scare you. The next time you are cursing at your 
computer for not being a good personal assistant, take a 
moment and think. You c'ould wait for an existing piece of 
soffw'are to lx enl lanced or a new piece of software to emerge, 
which is wTiat most people do. Bui if you know liow to 
program, you could write it yourself. Embrace that first step^ 
and rU see you next month. 
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HISTORY 

As with :iny Unix operating sysierri, Macintosh OS X 
r<j‘Ct)gni2es tlic use of environmenL varial>Ies. For a quick 
relresher, environment variables are traditionally used in shell 
scripts to reffieve information about rite operating environment. 
Common environment variables aie used each time a new 
Tcmiinal session is launched, including PATH, HOME, and 
other less common variables. OS X extends this concept with 
applic:alion bundles and Uiinch Services. Let's begin by 
examining the Iradiliona! u.se of environment variables by 08 X 
and their associated scope. 

The Terminal 

The .single most common invocation of envitxmment 
variables is when the Terminal application Ls launchtxl. Each 
Lime a new shell is opened by ijie Terminal application, a new 
session is created with system wide environment variables. Let’s 
look at the two environment variables that are created for each 
.se.ssion in a standard Tiger insLallation. 

PATH 

Tile PATH environment variable is probably llie single 
most common variable that is changed in any teniiinal session, 
hi a standard OS X iastallation, the file /etc/profile is used 
to set the PATH variable, ft is al.st> used fc^r any remote session 
when connected to any remote machine with ssh. By default, 
the variable is set at PATH='Vbins/shin: 
/usr/bin:/usr/sbin", Why might one change this 
default value? ’Whai if useful binaries live in other direciories? 

As an example, a standard fink or maeports installation 
installs binaries either in /sw or /opt/local/bin. In this 
case, the mcxiification of profile to reneci Lite directory is 
important. For Maeports, open profile in an editor and add 
/opt/local/bin to the PATH. Any session created with the 
Terminal aj>pIicaiion or via ssh will now seardi ihe PATH 
including /opt/local/bin. Any binary diat has been 
installed in /opt/local/bin is now available to a Terminal 
session or a remote ssh session. 


One quick note: he careful when setting the PATH system 
wide, as Liie PATH Ls searched beginning with the first directory 
ii.sted. When installing maeports, or fink for that matter, if the 
diredofy is listed first, the binaries installed by these collections 
are used first. Tliis might be problematic if the system binary is 
what is desired wfien calling any program. 

PSl 

PS1 is CTcated for each new Terminal window through use 
a second file in /etc, bashre. Tins file creates the custom 
command prompt, showing hostname, current working 
directory, and username, Tliis file can also altered, as 
profile can, so tlxii any user logging into die system ha.s an 
iclentk'al command prompr Note though, the bashre file is 
only read when using the liash shell (the default shell in OS X 
10.4), noL when using other shells such as tesh, or zsh. 

One last bit about OvS X, and the use of the Terminal 
application. Environment variables can be set in any Terminal 
window. It is important to note that any newly scT environment 
variables are not inherited if a new shell session is invoked, 
and cannot, therefore, lie depended on. For this reason, it is 
fiesL practice, at lea,st, to edit profile to apply environnienl 
variables for each user on the host operating system. 

Graphical User 
Interface applications 

OS X has the unique ability to use a plisL stored in 
“/.MacOSX/environment •plist to access any 
environment variable. Tlie plist is registered by loginwindow, 
so rhar non-Terminal based applications could use environment 
variables for dieir opemtion. However, one environment 
variable, DYLD_LIBRARY_PATH, was noted as a security risk 
in Security Update 2007-CK)4. As noted on the MacEnterprise 
list, llie change in behavior alTecLed some applications, most 
notably the IBM Workplace Porms Viewer, used for 
governmental grant applications. If die environment.plist 
methtxl is subject to change, is there a more reliable method to 
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access environment variable.s? Yes, application specific 
environment variables! 

Application-specific 
environment variables 

Prior to laiinching any applinition, environment variables 
c'an be set in ihe info.pl isl file witliin an application bundle, 
brunch Services dien reads tire environment varialile, and uses 
it for dynamic configuration of the application, fhis methcxl is 
exactly whar was used from a suggestion by Jcxsh Wiscnlyaker, 
and implemented by Ben fTanes. Ix't's look at how it w^orks. 

By default, an application created in XCode includes a 
bare bones Info.plist file. "Hie file contains brisic information 
about ihe application bundle. It commonly contains 
informalion alx)Ut the application, copyright, icon file 
information as well as other application specific information. U 
really is up to the developer to specify information as listed in 
the Apple Runtime Configuration Guidelines. For the purpose 
of this article, the partial la r key of Interest is LSEn vironment. 
It is a dictionary value, and contaias a complete list of 
cnvinmmeni variables that are read prior to launch of the 
application bundle. Launch Scrv'ices read.s the variables, and 
use-s them when the applic'ation is launched. Ii is impoitani to 
note, tills use of environment variable only works when die 
api^Hcation is launched from the linder. Let’s return to the 
example application that created probiems to see how this 
works in practice. 

The first step is ojxming the ap]dicadon bundle, Most 
bundles are similar to Figure t lxlfvw\ 
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file tli^ir needs to be edited for any application bundle 
to regiwier an environment variable is Info.plist. Opening the 
IBM Workplace Forms Viewer lnfo.[>ljsg add llie environment 
variables required by this ap[>]ication. Here is the mlevant 
dk'iionary that is added: 

(key^TjSEnvi rofimentX/key) 

<dict> 

<key>DYLD_LlBRARY^t^AYH</key> 

<strirLg>/Application£yiBM Workplarie Foms/IBK 
Workpl acc Forms .app/Cotitents/MacOSt /Appllcatiotis/ IBM 

Workplace Formfi/IBH Workplace Forms 
Vi cwor * app/Con LorHs/MacOS/AFl/ 70/sys Leiii</string) 

<key>PUREEDGE INI</key> 

<st riiig^/ApplictitloTJK/iBM Workplace Forms/LflM 
Workplace Forms 

Viewer .app/Gotitents/MacOS/FureEdgeAPI. iniC/string> 

</dict> 

Take a close look, tlie key is specified in Uiis example as 
documented by Apple's Developer documentation, 


LSEnvironment. Two separate environmental variables are 
then set, DYIDJJBEARY.PATH, and PURtiHDGH_iNL Other 
applications c:an use this exact melhod, incItKling SyBase SQL 
Any^^here 9 and USAnimation’s Harmony. 

Anned with the knowledge of liow lo set environment 
variables, both for the terminal and for Finder based 
ap[)lications, it should be trivial to correct appliLitrions which 
do not function as expected il environinent variables are not 
set. Until next month, see you on the lists! , ^ . 

Villi 
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Advanced Tables 
with AppleScript Studio 

Learn how to support editable tables 
and drag-and-drops 


By Jose R.C. Cruz 


Introduction 

In j. prcvitjus artic:luj :i Tiihlc VJcvv Project in 

ApphScripi Studio, Ikiijaniin Walclie .showed how to use 
AppleScript Studio to display taluilar dnui. He demonsirated 
how to use Interface Riii Icier lo prepare a table view. He (Jien 
sliow^"d how to use the table's data source protierty to display 
the desired data. 

Today, we will take the subject of uible views a few steps 
furtlicn First, we will kjok into the concept of editable tables. 
We will leant two types of editing modes and how to 
implement each type. Second, we will look into the 
c'oncrept of table drags and drops. We will learn how to 
support drag-and-droi> operations within the table as 
well as outside of the table. 

At the Lime of this WTiting, Apple does not provide 
any useful iiistnictions on the sulijeet of table editing, 
and table drag-and-drops. It is hoped that this article w'lll 
serve as an elTeciive sul>siiiiiLe. Also, as a Ixmiis, readers 
can downk^jad the Xcode prcjject, MoieTal:>ies, from tlie 
following MacTech lIRL. 

hltp://www, m octe ch, CO m/a rtici e s-i 
/mactech/VoL21/21,12/ 

Table ViewProject/index. htmt 

This project implenienls many of the concepts shown in 
this article. It requires version 2A.I, or newer, of the 
Xccxle environment, 

Editing Tabular Data 


differs on the aiiiouni of data to be edited. Also, each mode am 
!>e had on the same table on a per column basis. Choose the 
type mosi sniied Ibrthe data ai hand. 

In inline editing, tlie target data is edited dirtxiiy on t/?e 
mNe cell itself iVigim 1), Usd’s start an edit session by clicking 
on the desired cell. Tliey then end the session in one of two 
ways. First, they can press die TAB key, whieh move die edit 
focus to a different cell on the table. Second, they can press die 
ENTER key, which keeps the focus on the same cell Hither 


n A A 


Momlables Dtmo 


Njime 

Type 


Crash Reporter 

Folder 

n/a 

DiscRecortiing.log 

LogFIle 

122S8 

DiskUifItrv.log 

LogFrIe 

12288 

DivXToot.log 

LogFile 

40% 


” niin text docdmtnt ■ 

4096 

Pil^uicerResLiltsLog.txt 

Plain text document 

40% 

Java 

Folder 

n/a 

Java Console Jog 

LogFIle 

40% 

Sync 

Folder 

n/a 

Techspansion 

Folder 

n/a 


Types of editing modes 

Editable table views can support at least one of two 
possible modes: inline and panel editing. Each mode 
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Figure 1. Editing table data inline. 
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way, lilt: lal^^le view will display any changes inside to target 
data* 


Inline editing Is suitable if the data fits within the visual 
aresi of the tsil>lc cell. It also recjuires fewer resources since it is 
siiready built into the table view. But tliere are eases where the 
data is huger than the size of its cell* lliere are also eases where 
the data to lx* edited is pan of a larger set* For these cases, the 
mf>st suitable form is panel editing* 

In panel editing, the table displays llte target data on a 
sepa/afe view like a dialog or a window (Figure 2)* 'flial view 
can either be modal or non-mcxlal depending on the design 
goals. Alternaiiveiy, the table can also display the cbita on a 
separate set of fields residing on the same view as the table. 


and edit tlie rest of tlie addres,s text. This can be inconvenient 
if the length of the text is quite substantial. 

Implementing inline editing 

To impiemenr inline editing, first make sure that the target 
tabic etjiumn is editable. The best way to check is to double¬ 
click on the column in Interface Builder and chcxjse Show 
Inspector from the Tools menu. Then, from the 
Attributes panel, make sure lliat the Editable checkbox 
is set (Figure 3)* 

O O KSTableColumn tnip^ctor 

Attribute * ? 


O O ^ W&r#T4:W** 






fcAiimt 



LanFite 

mu 

[nsliytilitY.k»g 

LogFil* 
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4D9€ 


nainifxt docuincm 
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Haifi tvjct ftocumtflt 

mu 



n f * 

infei' • n«w fit* nafllf - 

r«chHwii 



( ^ In^ ^ 



Figure2. Editing data on a separate panel. 


Users Start an edit session by double-clicking on the 
desired cell. They then end the session in one of two ways. 
First, tliey can click on a piLshbutton widget to close the view. 
Second, they can click on the view's close widget, which again 
closes the view. 

How the users close the view also detenniiies if tlie 
changes to the target data arc saved into the table's data source. 
For instance, simply closing tlie view discards any changes 
made to the data. But clicking on the Enter pushbutton uixJates 
the data source widi those clianges* 

As mentioned earlier, panel editing Is preferred if the target 
data is part of a larger set* One good example is a table of 
addresses. Tlte street addrc,ss can have one or more lines of 
lexL Also, editing the address may also retjuire editing the city 
or state entries as well. 

Panel editing Is also preferretl if the target data does not fit 
the size of the table cell* Again, a gcxxl example is a table of 
addresses* If Lal>le space is limited, only a portion of the street 
address will be visible to the users at a time. Using inline 
editing, users will have to use tlie left/right arrow keys to see 
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Figure 1 . Setting the Editable attribute. 


Next, doulilc-click on the entire table view itself. Again, 
choose Show Inspector from the Tools menu, and then 
cluKise AppleScript from the panel’s drop down list* Scroll 
down until the Table View checkbox comes into view. Click 
on the disclasure triangle to display a list of event handlers. 
Then dick to select the cell value changed handler 
(Figure 4). Make sure to select the correct AppleScript source 
file before saving the changes made to the table view. 
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Figure 4. Selecting the cell value changed handler. 


'I'lie cell value changed liandk-r (.shown belcnv) lakes 
four labeled paranielers. 

on cell value changed aTbl mw aRow table column aCol 
value aVal 

^Jlie aTbl paranicicT ts a refcTcntx: to ilie talkie view' calling the 
IjandlcT The aRow parameter is tlie index of ihe table row 
!x?ing edited. 11ie aCol panuneter is a reference to llic table 
c'olumn being edited Finally, the aval parameter is the edited 
cell value itself. 

Listing 1 shows one way to use iliis liandler. In this 
example, tlie handler validales tlie changes made to the file 
sizes displayed liy the table view. 

The handler tirst reirkwes the .selected tafile row. Next, it 
retrieves the contents of the cell ftyp IVoin that table row'. If 
that cell has the string value ^FolderT the handler checks aval 
to see if it is .set to “n/a". If this is not the ai.se, the handler llien 
sets the value of the cell fsiz for that tal>Ie row back to “n/a^ 
Now if the cell ftyp Ls not set to ^Folder'*, the handler 
checks to sec if aVal is set to a non-negative value. If this is 
not tlie ose, the haJidler then sets tlie cell fsiz for tliat table 
row' to zero. 

Listing 1. Handling a change 
in a table cell value- 

on cell value changed aTbl row aRow table column aCoi value aVal 
local tRow, tTyp, tOrg 


— check the current item type 

sot tRow to selected data row of aTbl 

set tTyp to contents of the data cell "ftyp” of tRow 

— validate the data change 

if (tTyp is equal to "Folder”) then 
rf (aVal is not equal to "n/a") then 

set the contents of the data cell "fsi2" of tRow to "n/a” 
end if - {(iVat i$ not equal to "nfa'} 
else 
try 

set tOrg to aVal as integer 
if (tDrg is less than 0) then 

set the contents of the data cell "fsiz" of tRow to 0 
end if - fcss tim 0) 

on error 

set the contents of the data cell "feiz" of tRow to gTemp 
end try 

end if - flTyp is equal to ""Foidfr) 

end cell value changed mo aRcto tatHfOikmn aCd wlut* tfVa/ 

A problem with the cell value changed hiindler is 
tliat it does not preserve the previous cell value. Once the 
handler is invoked, iftc aVal parameter already contains the 
new value for that cell. One way to solve this is to add a 
selection changed handler using Interface Builder. Then 
implement the handler as shown in Listing 2. 

This handler Ls invoked each time users selects a row on 
the table view. It retrieves the conienl.s of the cell fsiz, and 
stores its value into I he global variable gTemp. llie cell 
value changed handler then set the cell fsiz with the 
contents of gTemp each time an error occurs. 

listing 2. Storing the previous cell value. 

global gTernp 

on selection changed aTbl 
local tRow 

— retrieve the selected row 

set tRow to selected data row of aTbl 

— buffer the data value 

set gTemp to the contents of the data cell "fsiz" of tRow 
end selection changed -- aTbl 

Since one of the handler's parameters is a rtTerence to a 
table view, it is possible for more llian one table views to call 
the same handler If this is the ca.se, make sure to identify whicii 
table is calling the handler at that time. The best way to do so 

is to retrieve tlie name property of the view, 
set tNom to name of aTbl as string 

Make sure as well to recast the proj>erty value as a string lKil>re 
performing the IL> tests. Failing lo do so can result into some 
interesting errors. 

Implementing panel editing. 

To implement panel editing, first make sure that the target 
table column is not editable. To do so, display the lo.specUir 
panel for lliat colunm, and clear the Enabled checktox 
(Figure 5). 'then choose AppleScript from die panels drop 
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down list, and dick to seiea the double clicked handler for 
the entire table view. 


Sort Key : 

Son Seleaor: compare: 
Sort Order: Ascending 

Cditabi^ 

^ Live Resizable 
^ User Resizable 

Use Oefauit Data Cell 


Figure 5. Clearing the Editable attribute. 

*l'he double clicked handier (shown below) takes a 
single input argument. That argument, aTbl, Ls a reference to 

the calling table view, 
on double clicked albl 

But other table views can rail then alxjve handler. Other U1 


eontrrjls that are not table views can also call that same handler. 
One way to identify which contrt>l made die call is to use an 
if-then consmicL 

if (the class of albl is table view] then 
set tNom to the name of aTbl 
if (tNom is equal to ’’oTbr) then 
— your code goes here 
end if - (tMtitti is qiiuf m "oBD 
end if - (the driss of aTbl is wifa?) 

In the alnive example, the first if...then biocrk retrieves 
and tests the class of aTbl, If aTbl is a table view, the second 
block retrieves and tests the name proiKfrty. Then^ if aTbl has 
the correcl name of "<>T1>1”, the code for that table view is 
executed. 

Listing 5 shows one way to implement panel editing with 
the double clicked ha tidier. First, the handler retrieves the 
row and colunin index of the double-clicked table cell. Next, it 
is retrieves the txintents of that cell. It then displays tlie data on 
a modal dialog to the users Ibr editing. Once users have edited 
the data, they click on tlie Enter pushbutton to commit the 
changes back to the table. 'Ibe handler then u^xlates the table 
cell with the updated value. 

Listing 3. Handling a double-click event- 

on double clicked aTbl 
local tRow, tCoi, tDat 
local tMsg 
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-- initialize the following locals 
set tRow to clicked row of aTbi as string 
set tCol to clicked colymn of aTbi as integer 

check the selected data column 
if (tCol is equal to 1) then 

” retrieve the original string 
set tRow to selected data row of aTbi 
set tDat to contents of data cell *'fnom" of tRow 

— prompt the user for a new string 
display dialog pNewName default answer tDat -r 

buttons pBtnList default button "Enter'' 

— retrieve the new string data 
set tDat to result 

If (button returned of tDat is equal to "Enter") then 
set tDat to text returned of tDat 

“ update the data source 

set the contents of data cell "fnom" of tRow to tDat 
end if ~ ffeuftow rchiriiEd ttf tDat is fo 
end \f-(tCol = l} 


Dragging and Dropping 
Tabular Data 

Getting started 

Drag-and-drop aaions are another way of managing 
tabular data. Users can select a row or L'olumn on the talkie view 
and drag them to a new location cjn die same table view. Users 
can also drag tlu)se same seleaioas and drop them onto a 
different table view. And in .some cases, users can drag those 
selections off the table’s parent view. Doing so will cause the 
table view to delete thase seledions from its chtta source. 

In fact, tlic table view itself already supports the dragging 
and dropping of table colutiuis. All it ret]Lires is to set the 
Column Ordering checkbox on the Show Inspector 
panel {Figure 6) lor die entire view. But the table view does not 
have the same level of support for dragging and dropjjing table 
rows. Hnabling this feaitire will re<iuire some effort on our part. 


on error tErr number tNum 

“ did the user cancelled the edit session? 
if not (tNum is equal to -128) then 

set tMsg to "[Error] MoreTables:double clicked:" 
set tMsg to tMsg tk tErr £i"(" & (tNum as string) h ")" 
display dialog tMsg buttons {"DK") 
end if - is Cijjw/ to -128} 

end try 

end double clicked - tiTliJ 


Notice that the above example uses the display 
dialog command to serve (he editing panel This dialog 
generates the error signal -128 when users click on the 
Cancel pushbutton. To correctly process the signal, the 
handler uses a try»,end try block. The on error sub- 
block traps any errors generated by the code. If it identifies 
the error as a -128, the sub-block quietly ignores ilie error 
signal. Otherwise, it displays a description of the error using 
a modal dialog. 


0 


o 


NSTableVrew tnspector 
Attributes *) 


8ackgrnd Color: 
Grid Color- 
Border Style: 



Scroller Size 
Focus Ring 
Resizing Mode 


Smalt 

Default 

Reverse Sequential 



Row Height 
Autosave Name 


17 Columns: 3 

Tag: 0 


Combining inline and panel editing 

As stated earlier, a tal)le view^ can support inline and panel 
editing modes on a per cokiino basis. All that is required is to 
use the Show Inspector panel (Figure 5X and ,set or dear 
tlie Enabled checkbox for each tal>Ie column. 

For instance, the table view in the MoreTables project has 
the Editable checkbox cleared for the Name and Type 
column. Then it has the sarne checkbox set for the Size 
column. So, when users double-click on a cell in the Name 
column, the table view starts a panel editing session. Rut 
when users click on a cell in the Size column, the table view' 
starts an inline editing session. 

However, if users try to double-click on a cell in the Type 
column, the table view does not start a panel editing session. 
Though the doubie-click event is routed to the correct handler, 
it is reject by the code since it occuned in the wrong column. 
Examine the first if,*.then consmict in Listing 5 to see how 
this is done. 


Allow. 

5! Empty Selearon 
Multiple Selectiori 
CQlumrLSelectigtt 
Column Ordering^ 
toiumn Kesizing 


Display: 

^ Vertical Scroller 
Z2 Horizontal Scroller 
^ Vertical Lines 
^ Horizontal Lines 
^ Column Headers 



^ Use Alternating Row Background 

_Automatically Hide Scrollers 

Hidden 


Figure G. Enabling column reordering. 
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The drag info object 

llie drag info olijm (Figure 13) is the ntaia comptmenj of 
all dnig-and-drop ojx^ratioas. Ii carries all the information ttuil 
describes die operation. Itie object has a number of useful 
properties and iiieduxis. But the most interesting tine is the 
pasteboard property. 


drag info 

deBtinaiion window 
im^kge 

image location 
location 
sequence number 
source 
source mask 



Figure 7. Structure of the drag info object 

The pasteboard property (Figure 15) serves as the 
container for drag-and-drt)p data. It can carry a wide range of 
data, from integer values to ILsis or records. Tlie properly 
consists of two parts, llie first part is a list of type signatui^s 
for each data it carries. The second part is die data itself. 


i pasieboard | 

content(s) 
name 

preferred type 
types 

_ 


Figure 8. Structure of the pasteboard object 


Now the drag-antklrop process sets most of ilie properties of 
the drag info objea. In fad, the only property that should Ik; set 
by ccxlc is die pasteboard. To danoasirate, iissume tlie variable 
tClip as die jyasielKxird propeny. To store the siring "Hello 
world" into tiie piisteixxird, use the following code statements. 
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set preferred type of tClip to "string" 
set content of tClip to "Hello World" 

To fuiridve Uk* siring rpom ihc pisleboard, use ilic following code staTcmcnrs. 
set preferred type of tClip to "string" 
get the content of tClip 

But the dnig info object only allows re;td-access to its 
pasteboard property, A scfximte kitidler is needed lo store data 
into thiu property. TliLs IrancUer is descriixfd in die next subtopic. 

Preparing the drag event 

‘Ibe iat>le view must first be prepared to jiupfx>n dng-and- 
drop operations. To do so, select the view in Interface Builder 
and choose Show Inspector from the Tools menu. Then 
click to select the handlers sho^vn in Figure 17. 
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Figure 9 Selecting the drag-and-drop handlers. 
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Next, the ruble view needs to re^*isier lire correct data 
types. To do so, use the Show Inspector panel to select 
the awake from nib handler for that vieWn Then update 
the handler with the code statements shown below. 

on awake from nib aTbl 

tetl aTbl to register drag types {'*row&‘', “file names”} 
end awake from nib - uTM 

In the above example, the table view aTbl registered two 
data types: rows and file names. 1'he first type refers to 
selected table rows, the second to selected files. 

The prepare table drag handler (shown below) is 
executed at ihe sStari of a drag event. 'Ibis handler initializes 
the drag info object it lakes three input parameters. 

on prepare table drag aTbl drag rows aRows pasteboard aCiip 
The parameter aTbl is the table view that started the drag 
event. The parameter aRows are the lal>le rtjws selected by 
users. It contains not the row indices but the actual row data 
themselves. Lastly, the parameter aClip is the pa.sieboard 
object. It is through this parameter that the drag info object 
gets its pasteboard property set to the right data. 

lasting 7 shows how to use this handler. Here, the 
handler sets the preferred data type for ilie pasteboard 
aClip to ""rows". Next, it set.s the contents of aClip to the 
selected tal>le rows. The handler then returns a true to 
allow the drag event to continue. But if it needs to abort the 
event, perhaps due to an error, ilie liandler shoukl then 
return a false. 

Listing 4. Starting a drag event. 

On prepare table drag albf drag rows aRows pasteboard aClip 
" set the following properties 
set preferred type of aCltp to Vows” 
set content of aCHp to aRows 

— rettim a true hi continue the drag 
return (true) 

end prepare table drag itRmm jmklmrd aCfip 

Preparing for a drop event. 

The prepare table drop handler (shown bekw) is 
executed at the stari of a drtjp event. U also initializes ihe drag 
info object. The liandler takes four input parameters. 

on prepare table drop aTbl drag info aOat row aRow drop operation 
anOp 

The parameler aTbl is the table view Mcepting the dragged 
data. The parameter aDat is the drag info object initialized 
by the prepare table drag handler. The parameter 
aRow i.s the location where the dragged data will [>e 
drop[)ed, 

I'inally, the para meter aaOp is the drop mode. If this 
parameter is set to 0, the data will be placed on the sekettfd 
But if it is set to 1, the default mode, the data wall be 
placed above the selected row. 

Error! Reference source not found, show^s one way 
to use this handler. The liandler first sets the tlefaull drag 


operation to no drag. Next, it retrieves the type of data 
stfjred in the drag info's pasteboard If the data is a list of 
table rows, the handler returns a move drag operation, 
This means the daia is [placed at the new locale and 
removed from the old one. 

On the other hand, if the data is a list of filenames, the 
handler returns a copy drag operation. This means the 
data is .still placed at the new locale. But it is not removed 
from the old locale, if applicable. 

Listing 5- Starting a drop event. 

on prepare table drop aTbl drag Info aDat row aRow drop operation 
anOps 

local tTyp, tDrg 

-- set the default operation 
set tDrg to no drag operation 

— check the type of dnjp operatitm 
if (anOps Is equal to 1) then 

" set the type of drag tjporation to use 
set tTyp to types of pasteboard of aDat 

if (tTyp contains "rows") then 
set tOrg to move drag operation 
else if (tTyp contains "file names") then 
set tDrg to copy drag operation 
end if - "muis'') 

end if - fti/rOps is qiid m U 

— return the desired drag operation 
return (tDrg) 

end prepare table drop - oB/ (fmjj rw/tJ uDat dwfi fifuratmu wwOps me 

Handling the drop event 

The accept table drop handler (shown below) is 
executed after the drop event. Its purpose is to take the 
drugged data, and place it correctly on the table view. Tlie 
handler takes four input parameters. 

on accept table drop aTbl drag info aDat drop operation anOps 
row aRow 

The aTbl parameler is the lable view accepting the dragged 
data. The aDat parameler is the drag info object The 
anOps operation is the drop operation specified by the 
prepare table drop handler. Finally, the aRow 
parameter is the row where the dragged data will be placrd. 

Listing 6 shows one way to use this handler. In this 
example, the dragged data is a selection of table rows being 
moved to a new lijcation. 

The handler first disables aTbl's ability to update itself. 
It then counts the number of table rows present and sets the 
local tTmp to a null list. Next, the handler compares aRow 
again.si the number of table rows. It u.ses the re.sult.s of the 
comparison to set the final drop location on the table view, 
The handler then retrieves the pasteboard contents of 
aDat. It append.s each data as a talkie row to the local 
tTmp. Once done, the handler then adcLs the contents of 
tTmp to the table view. Finally, it enables aTbl's update 
mode, thus refreshing the table's list of data. 
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Listing 6. Handling a selection 
of table rows. 

on accept table drop aTbl drag info aDat drop operation -> 
anOps row aRow 

local tDst, tSrc, tTmp 
local tCnt, tRow^ tTyp, tRec 

“ the following locnls 

set tTyp to types of pasteboard of aDat 
set tSrc to data source of aTbl 
set tCnt to count of data rows in tSre 
set tTmp to {} 

— disable the table update event 
set update views of tSrc to false 

— determ me where lo place the new row 
if (aRow > tCnt) then 

“ place the new row at the end of the list 
set tOst to missing value 
else 

— place the row above the target row 
set tDst to the data row aRow of tSrc 

end if “ (wRiw > tCnO 

” determine what type of data is being dragged 
if (tTyp contains "rows") then 

— drag:type:table:row 

— retrieve the following table data 

set the preferred type of the pasteboard of aDat to "rows" 
set tCnt to the contents of the pasteboard of aDat 

-- create a copy of the table data si^urce contents 
repeat with tRow in tCnt 

copy data row tRow of tSrc to the end of tTmp 
end repeat - with tRouj m fCnt 

— add ihe moved row entry 

repeat with tRow in tTmp 

— determine if the moved entry should be inserted or 

appended 

if (tDst is equal to the missing value) then 
— drag:row:opera lion:append 
move tRow to end of data rows of tSre 
else 

“ drag:row:oporahoniinsert 
move tRow to before tDst 
end if -- (tRow is equal to the missing value) 
end repeat with tRow in tTmp 

else if (tTyp contains "file names") then 
“ drag:type:file:name 

— ...see Listing 12... 
end if " is etjud fp 'rau's'') 

“ enable the table update event 
set update views of tSrc to true 

- return a true to continue the drop 
return true 

end accept table drop - aTbl drug info aDat drop akO/?!; nmf sRm 

Listing 7 shows a different way of using the accept 
table drop handler. In this case, the dragged data consists 
of a selection of files from tlie Finder. 

First, tlie handler follows the same steps to retrieve the 
dragged data from the drag info object aDat. It then retrieves the 


POSTX patli to each file and converts it to a Mac05 patli fonnat. 
Next, the handler calls the getinf o utility method Tliis method 
i^trieves the Finder information for each file, and returns tlie 
resLilts ius a recoRl. Tlie handler dien adds a new data row to the 
table view and updates that row with the Finder informatitin. 
Finahy, the handler enables aTbl's update mtxlc, which 
refreslies its data display. 

Listing 7. Handling a selection of files. 

on accept table drop aTbl drag info aDat drop operation anOps row 
aRow 

local tDst, tSrc, tTmp 
local tCnt, tRow, tTyp, tRec 

— initialize the fallowing lucals 

set tTyp to types of pasteboard of aDat 
set tSre to data source of aTbl 
set tCnt to count of data rows in tSrc 
set tTmp to {} 

-- disable the table update event 
set update views of tSrc to false 

delermiiie where to place the new row 
if (aRow > tCnt) then 

“ place the new row at the end of the list 
set tDst to missing value 
else 

-- place the row above the target row 
set tDst to the data row aRow of tSrc 
end if - fflRmy > fCn/J 

- determine what type of data is being dragged 
if (tTyp contains "rows") then 

— drag:type:table:row 
” see Listing 10... 

else If (tTyp contains "file names") then 

— dragitypedileiname 

“ mtrieve the list of selected files 

set the preferred type of the pasteboard of aDat to "file 
names" 

set tCnt to the content of the pasteboard of aDat 

if (the (count of tCnt) is greater than 0) then 
repeat with tRow in tCnt 

-- retrieve the info record 
set tRec to POSIX file tRow as text 
set tRec to getlnfo for tRec 

if not (tRec is null) then 

— determine if the new entry whould be 
inserted or appended 

if (tDst is equal to the missing value) then 
“ d rag: fi 1 e: opera tion :a ppend 
set tTmp to make new data row at end of 

data rows of tSrc 

else 

— drag:file:operation;insert 

set tTmp to make new data row at before 

tDst 

end if - f/RwriJ r5 equal to the missing Pflfwr) 


“ update the table entry 
set the contents of the data cell Tnom" 
of tTmp to the fnom of tRec 
set the contents of the data cell "ftyp" -r 
of tTmp to the ftyp of tRec 


70 July • 2007 


WWW.MACTECH.COM 






sei the contents of the data csW '‘fsiz'' 
of tlnnp to the fstz of tRec 
end if - wn/ (ite is nidi) 
end repeat ^ with tRuw in tCnt 
end if - (Hw courtt of tCnt is ^mter than 0) 
end if - is equal to 

— the table update event 
set update views of tSrc to true 

— return a true to continue the drop 
return true 

end accept table drop - aTM drag info aOal dr(Tp (jperafiun riimfiRtw 

Concluding Remarks 

Table vkws are an integral pan of many AppIeScripl 
applications. 1'hey allow users to view their data in a 
structured lahukir Ibmi. They also allow users to edit specific 
data items or move them to a new [ot:ale. 

AppleScript Studio helps in making an edimbie talkie view 
easy U) supf>orl. Users ran either edit the data directly on the 
table view, or on a separate panel view. Drag and drt)ps on 
table views are also easily done with AppleScript Studio. User 
can use drag-and-drops to rearrange table columns or rows. 
Users can also use iliem to add data frtim a separate 
application, such as the Finder, to a table view. 

Thanks to AppleScript Studio, table views can lx? an 
elTeciive and llcxible way of presenting data lo users. 
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Using NetBooting 
on the Mac OS X Server 

for delivery of mass client 
deployment 


t^ Criss Myers 


Preface 

In this OKxlern eni of high technical and support costs, 
it is very imponani to he ahie lo reduce llic support required 
at the client side. Tlie larger tlie network grows the less 
support time is available for each machine. Thus, tlie 
network team needs to be al>le to optitnize their time as 
much XH possible. Every system administrator wishes to lower 
the amount of downtime on the network. 'Phis reduces stress 
and pressure on the adminisiraiion team and keeps their 
users happy. Clients require more and more from their 
computer and its associated network, and demand instant 
technical sup|X)rt. 'fhe client needs to be able to turn ilieir 
computer on and for il to he in the .same state every time 
with limited or no downtime. The network system 
administrator needs to be able to make impi'ovemenis and 
upgrades, but if they go wrtmg, he needs to be able to revert 
to a previous working state as soon as possible. The most 
effective way to achieve this is through mass client 
deployment; this mearns each machine is setup identically 
and all updates are thoroughly tested offline liefore being 
deployed to the clients. Tim is nothing new to the computer 
market and similar systems are carried out on Windows, 
Unix, Linux, Sun and Novell networks. In this article, we will 
lf)ok at the often-overlooked Mac mass deployment system 
tool called NetBooting. 

Frequently used methods of 
achieving mass deployment 

1. Network Install 

Using Network Install, inachines are imaged over die 
network via a network image distril)uted from a server, llien 
each time an updated system is ready, it can be deployed in the 
same manner to the machines again. This imaging can be 


achieved by using Apple's Netlnstall, or BombiclVs NeiRestore, 
or Casper by JAMh‘ 

Thc.se arc great rncthtxls; it means that after each reinstall, 
ilie machines are setup identically and in a known stable 
working state. Any updates are tested offline before passing 
ihem on to ihe client, and the software and .^iystem can then be 
managed and controlled centrally by the administrator. 

Over lime however, the client machines can drift from diis 
installed state, either by changing preferences, removing files, 
system crashes, etc. This may require a full client reinstall. Viis 
causes downtime; the initial install created downtime and each 
reinstall carries with it more downtime, plus tlie time used to 
report the problem to the administrator in the first place, litis 
methcKl carries with it many poSsSible problems, but is suitable 
for mass deployment over a network. 

2, DeepFreeze 

DeepFreeze, by Faronics, is third party st)ftwarc that is 
mslalled onto the client system. Once setup, it ‘freezes’ the 
system at its ajnent .state. Any changes made during the current 
and future ses.sions will l>e lQ.sr Jifter a rebirot, Tlie only way to 
change the .system is to enter an "admiiT password and relxx)! 
the client into a lira wed state. This software prevents any 
unwanted changes to tlie system and returns tlie macliine to 
tile sttme state with eveiy reboot. However, it allows the current 
user freedom lo use the machine in any way they wash, 1‘his 
method is not centrally controlled and each client needs to be 
thawed individually before any updates can be applied. It Is a 
very useful piece of software for small network.s. 

3- Apple's NetBoot system 

The OS X Server has a system tool called Netboot; this is 
the same tool used for NelbcKiiing and Netlnstall, but we will 
focus on NetlxxXing, The server stores client system images, 
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which contJin a complete OS X system togeiJier witli any 
applications rcc|uired. I'he serv'er can supply as ttiany different 
images as required. Tliesc images are then availalile for NK>iing 
client niiichines. 'llie client machine, l)e it a PPC Mac with 
OpcnFirmware or an th’hbasecl Intel box, has Nellxjoting 
cajiabitiiics via BOOTP/DHCP t>ver the Ethernet port. Firstly, 
the client tools up and broadcasts a search for a NclIkh)! server 
via BOOTP/nuCP; the first available NetBool server tlien 
ackiitiwlcxlgcs ihis recjuesi. Tlte client tlien seeks out a DHCP 
server (which may or may not also lx: the liOOTI^ server) to 
receive its network details. Once it has its network sellings it 
Llicn conlacls the Nethoot server again and either requests the 
default image or a specific image sei via the Startup Disk. I'he 
Bcxit ROM is then copied to the client via TFTP (Trivial File 
Transfer Protocol), 'Phis protcx'ol sends very small packets of 
data from the scr\XT to Uic citenl. The Boot ROM is either 
copied from an NFS or HTTP share on the ,scrvcT. This share 
stores the Neilxx)t images. The typical place for tliis is in 
Lihrar\^/NeiBooi/NetB(K)tSl^; each drive can have a Netlx>ot 
share point if required to balance the load 

Once the client has tlie Bool ROM, it will then boot up and 
access the rest of the OS from the server and load it into 
memory'. It uses tlie local drive as a cac'he and vimial 
meinoryVswap space. When any infonnation is needed, it is 
acces.sed over the n<?twofk and loaded into the memoiy of the 
client. As far as the client is aware, ihe macliine lx)ois and runs 
as if everything was loaded from the local drive. The netwtjrk 
image is mounted on ihe desktop, the local drive is also 
mounCcxI, and it apfxiars as a separate internal drive. Since the 
information is stored on tlie server and only die infonnation 
being acces.sed is downlo;ided to the client at any one time, 
there is no limit on die size of the NetB<K>i image. Tiiis has an 
obvious advantage over Neilnstall; if your install image is 
which ii can be with a program like Final Cut, it is going to take 
a long time to install over die network ontt> a single client, lei 
alone a whole lab. Whereas w^ilh NetBoot dierc is no differencre 
lx:tween accessing a 5GB and a 45GB image. 

Both Unix and Linux systems ulm use this rechnolog>', 
Apple implemented this in tlieir second version t>f OS X Serv'er 
called OS X Server 1,2. Initially it only supported OS 9 but, with 
the release of OS X 10,0 Cliem, OS X support was added. 

Network and System 
Requirements 

Since Netbooting depends heavily on network infrastructure 
and memfiry in the client machine, this is not a cheap setup. 
The faster the |>r<xc,ss<>r and the more memory the client 
machine lias, the smoother the performance. This is esfiecially 
true if you are running the Pro Apps such as Innal Cut. 'Fhe 
more clients you NetlxKit the more bandwidth you w'ili 
require. Since Netlx30i uses TFTP, it docs nt>i create large 
pac^kei transfers but rather a large amount of traffic. A switch 
is a must, and a managed switch with pon bonding is 
advantageous. A small network can run on JOOBa.seT hut for 
larger networks a lOOOBasel' or higher may to required. As die 


files are being distributed from a server, the server 
specifications are imfiortant also. On tlie .serv'er side, fhe faster 
the server, the totter. For larger networks, Ixinding two or 
more gigaliyte Ethernet cards together will help performance. 
The NciIkkiL images should lie smred on a separate drive from 
the system, and for opltinal |KTfonnance, an Xserve connected 
via Fibre Channel can be used. The Netlxiot serv'er should also 
only l>e running those services required for Nettooting such as 
NFS or HTTP, NeUkKii, BOOTP and DHCP/DNS, If another 
server is not providing these services. For even more 
perfonmmee, muktple Neiboot .serv'ers can be used, but only 
one DHCP server is recjuired. The t lienls will ihen connect to 
rile first available Netboot server An OS X Server can provide 
OS 9 and OS X images and can provide toith PPG and Intel 
images. OS X IQ.5 OtoopaaP) will offer a single image that 
can boot both PPC and Intel macliines, l)ul until then, a 
separate image is required for each hardware type. 

Advantages of Netbooting 

The advantages of NeiRooting over other methods, such as 
Deepi-reeze, are diat tlie system is centrally conlrolled, setup 
and received via a server. Any clianges and ujxlaies are 
perromied from the serv'er; the client machine never needs 
installing or reinstalling to take advantage of any uptlales. The 
advantage over an install system is the reduced downtime. No 
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time is wasted mstalling the system onto the client machine or 
reinstalling to |x:rform updates. This also reduces network 
Lraffic. Tlie only downtime is the time taken to boor the client 
macliine, which, with a fast network and optimized system 
takes nearly the same time as [xK>ting from its local drive. The 
client is thus unaware of die fact that diey are running from a 
network-controlled image. 

Nerbooting is excel lent for a Schix)! or University setup 
where lalx)ratorics are retjuired to be njnning during the day 
and where there is a limit to the available time for maintenance, 
lliis can mean that the network is free for client use and is noi 
lied up Rjnning installs. It also means tliat staff is free to test 
strfiware and updates without impacting die clay-tcMlay running 
of the laboratories. Netbooting also offers secure setups; 
because the system is run from die server, there is no 
information stored on the client, and information that is cached 
Ls lost after a relxxX. This is ideal for the military or for l>anks, 
where vital, secure and privaie information is mA retrievable 
from a client machine. One liank that I know of, with over 1400 
Nelliooted Macs, uses this system. 

Step by Step guide to creating 
Netboot images 

'Ihis guide is liased on my own experience using 
and my own perstinal preferences. I have NeiBooted OS 9 and 
OS X clients. For imaging, a se]>araie external drive is sufTicient, 
The image drive needs to be preserved in a stable state so that 
it does not gel comipled and oinnot he used for anything other 
than creating the Netlkxil liase image. Any updates and 
additioas will Ik" installed onto this drive and therefore any 
coraiption will lie passed onto the clients. A sepanite (,second) 
cloned drive am he used for testing puqxises, and mxlates - 
software can lx; installed and tested on the clone drive prior to 
install on the main imaging drive. 

L OS X Server - Setup an OS X Server as required for your 
network and enable NelBtxiting via Server Admin, this 
automatically turns on NFS. Fig. 1 shows the setiings re(|uired. 
Fnablc an Etliernct port and select a Volume for images. "Client 
Data" is only reqLiired for headless boot up (hcx)ting clients 
with no internal hand drive, not recomiiiended for [K-rformance 
issues). 
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Fig. 1 Server Admin, NetBoot, Settings, General 

Use a sepanite internal drive for the Netlxiol images, to do 
this tjeaie a share fxiint on this drive and make sure it has an 
NFS Export setting to tlie World with read-only access. Thus will 
l>e die drive you select via Server Admin. 

Fig. 2 shows these sellings in Workgujup Manager, Sharing, 
Protcx’ols, NFS Exfxirt Settings. 

For perfonTuince, you am lx>nd multiple Eiiiemei pons, and 
use an Xserve KAIl) to .store your Images. Setup DHCP and DNS, 
eiilier on die .Siune server or a difterent .server ;is appropriate. 

2, Setup a client admin Mac with OS X and Server TtKils. tt 
c^n be a FPC or Intel Mac, This Mac will be used for cwaliiig ilie 
Netboot images and d<x^ not have in lx* the same hardware as 
ihe image you am creating. Tlie faster the machine the quicker 
the image will be created. 


Ceneral Accesi Pfoto^li ^ frletwork Mount 

-' Export Settingi ^ - 

^ EKport this item and its contents to: 

Wortd. 

Expo/llng this Item to WoUd*' 
provides unauthenticated access to 
the item and itt contents. 


C Map Root user to nobody 
^ Map All users to nObody 
^ Read-only 


Fig. 2 Workgroup Manager Settings 
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3- Gti an external Firewire liard disk - Firewire 8(K)j ofr course, 
will provide fiister imaging. Buy multiple copies of ihe same 
drive so you can create clones for backup and testing j>uq)oses. 
One thing you don't want to do is to lose the data on tliis drive, 
especially once you Hlivc made ctmsiderahle changes and 
updates over lime. 

4. Connect the Firewire drive to either a PFC or Intel 
Mac\ It c'an be the same Mac as your admin Mac, but it needs 
to be the same platform as lltat For which you are creating an 
image. Use a PPC Mac to create a Pl*C setup and an Intel Mac 
to create an Intel .setup. It doesn’t matter wdik li model it is, 
i.e. you can create an iMac Net Hoot setup using a laptop. 
Create a separate setup for both PPC and Intel on separate 
drives. 

5. Boot this Mac frt)iTi an install DVD/CD and install OS X 
onto the external Firewire drive nt>i the internal Mac drive. 

6. Reboot the Mac to tlu: external Firewire drive and finish 
I he install and setup. 

7. Install any OS tipdates and configore the system, 
accounts, network, directory access, etc. and remove anytlting 
not rec|uired such as Airport Admin or unwanted language 
.setu}>s. Try to reduce any unwanted items. 

B. Install any software updates tiiat you wish to deliver 
via this NetlKKH image. I'he volume of data on this drive 
doesn't mattery NetBotaing docs not require a small 
volume. Net Booting 5gb is the same as NetBfroting 45gb as 
only the infcirmation being accessed is downloaded at any 
one time. Programs like Final Cut will create a large 
volume. 

9. Test all tfie software and configure as required. 

10. Shutdown the system and conned llie exlernal drive to 
your client admin machine and Ixrot the admin Mac. You now 
have an OS X system to image. However, if you create an 
image from this external drive you wall gel a NeiR<K)t image 
w ith zero free .space. If your drive is 80GB and it is using 45GB 
for data, the resulting NelR(X)t image will be 45GB. Programs 
such as Photoshop require scraich disk spac:e; the default 
kx:alion for lliis is on the system drive. In tliis case, it will lx^ 
tile 45GB NetBooi image. We therefore need to cTeate some 
free space, 'lb do tliis we create a blank “dmg” via Disk Utility. 
Create as big a *'dmg" as you require onto ilie external drive, 

11. Launch System Image Utility from the Admin Tools in 
/Applications/Server/. This tool will create yourNetlioot image, 

12. Select “New BooC and under "'General'* give it a name, 
a uni(|ue index number, and a descTipiion, use NFS and Local 
path. I personally advise NFS rather than IITTI^ for jx’rformance 
related reasons. 
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Fig. 5 System image Utility 

13, Under "Contents” selea your Firewire hard disk from 
tile "Image Source" and choase your language. 

[4. Prom the *‘Mtxlel Filter" you can filter this new image 
to IxKH only specific iTKxlels; ihe list will display the available 
HKxlels for the sptrttu' arcltiieciure. You can use* this filter to 
pa'venl unwanted Macs from lxx>ting from the network. 

IS. Click "Oeate", name the image and save it to your local 
drive. 


16. Once the image Is created, you will have a folder called 
XXX.nbi - nhi for Net Bckii linage. Connect to your server, 
mount die NetBootSPx share point, and upload this folder. 

17. Once uploaded, open Server Admin / NetBoot, select 
the newly added image and activate. Seleci one as a default 
Image. 
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Fig. 4 Enabled images showing Index, 
Architecture, and Protocol 
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18, Tliiii image will m)W \yc avaikihle to any Mac of the 
jiiime hardware on the network, via System Preferences / 
Stanu[> Disk. You i:an use Apple Kemote Deskloj) (ARD) to set 
the Startiii> disk ibr ARD c:ontro]|ed machines. This way you 
can change the Startup disk for a client machine withtjur the 
user needing to know. So, if you create a new Net Boot image 
with updated software, you c'an I'hange the clients Startup disk 
tf) this new image and they iicxl lime they rehtiot the client 
they will b(K>t from the new inuge, 

19, On the server, open the xxx,nl3i folder and mount the 
System.dmg. It will mount onto the desktop. You can now 
perform some basic aiterations (to prevent corruptions do not 
mount this while a client is Netikioting from tr). You can now 
delete the “dmg"* you created lo give yourself free space. You 
can also inslall or copy flies to the System.dnig at this .stage 
also. 'HiLs is useful if you want \o make minor changes to the 
image without having to re-image. 

Under die Net Boot section of Server Admin select 
overview, from this window you can see whether the Netbooi 
Service is nmning, how many images and wliat type they are 
and if they are running or stopped. 
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Fig. 5 Server Admin, NetBoot Overview 


Server Admin also allows you to filter ihe NetBoot prcKess 
to cenain MAC addresses; this is also useful to f>reveni 
unauthorized Macs from Ixioiing from the network. 
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Fig. 6 Filtering by MAC address to allow only 
certain clients Netboot-ability 


T roubleshooting 

Nh'S Ls ret|Uirecl for NciBcKXing, soinetimes the NI'S process 
will stop, there is m> way to stai1 tlie service via St*rver Admin, 
the cjuickesl way is to t)[ 7 ea Workgroti]:) Manager anti un-sliare 
the NetBoot k)ltler anti then re-share it. Since iliis share I’equires 
NFS for its NFS Rxpt>n, it autonuitically starts the NKS service. 
[Ed. Noic^ you on also hand-crank NES in a shell hy ailiing the 
nfs cbemon diredly: “sudo /sbin/nfsd -t -u -n 6"* Hit 
the man page ftjr more information.] 

NelBtxn can require BOOH* to lx? nmning, anti I find this 
dtKfs not always launch ai Ixwt up. To start BOOTl* manually, 
open 'lenninal and type, sudo -/usr/libexec/bootpd 
and this will launch the service, then run Disk IJiility to repair 
the jXfnnissions on the Startup di.sk; this normally fixes the 
problem for the next bcxrt up. 

NctBtM)t alst> requires a working DNS system, so make sure 
your DNS is working properly. 

Boot up process^ error indicators 

1. On IxKJt up of a client machine, you will get a flashing 
globe icon; this Ls the client bnyadcasiing for a Neflxxx serv'en 
This icon is a scjuarc icon with a glolie on a PFC Open 
Firmware system, and a grey glolie icon on an Intel EFI 
machine. Hiis icon should nor flash for very long. Tliis icon will 
stop flashing once a NeiBrna server has l>een found, 'I he client 
then displays a small spinning grey globe icon while it gathers 
its DHCP settings. If die client does not flntl a server it will 
timeout and will Ixxu from the kx'al drive. Check that lxx>tpd 
is nmning on the server. 

2. 'I'he client then displays a spinning grey wheel icon 
while it downloads the Bcxit ROM. If the client displays a *‘no 


3. Once the Boot ROM is loaded into the client's memory, 
it downloads and initializes the rest of the Operating System. 
If the NetB<KH image is corrupted the client will kernel panic 
at this stage. If the client shut.s down after die Bool ROM is 
loaded then this indicates that the client’s hard drive cannot 
lie wrinen to. 

4. If the NetBcx)t -server needs u> be rebooted at any time, 
the clients will go oflline and they will get the spinning wheel; 
once the NetBoot server is hack online, the dienls will 
automatically reconnea an<i go hack online without loss of 
service t)r refxxH. 

5- If the clients get repeated spinning wheels or run slowly 
this maybe due to poor network performance and 
optimization. You may need to increase the bandwidth 
available or add extra NetBoot servers as well as adding 
additional memory to the clients. 

Conclusion 

Neiixjot is a valuable ttx>l for any administnitor. ibe ability 
to keep control of images in a central location can save 
incredible amnunt.s of time, anti keep users comfortable with a 
consistent experienc:e across rnacliine.s. 

If you have the technical re.soua'es and wish to reduce 
your technical support costs and downtime then NetBooting is 
for you. It does rec|iiire high technical cn.sts but it also redoees 
the technical su()pon costs as well. Since the client is never 
imaged, any changes are instant once the client is reb(K)ted. 
Reverting back to a previfHis work!tig version is as simple as 
reixMXing the client. All testing and developtnent Is c:arried out 
offline and changes are passed to the client via a sUirt-up disk 
change. All of this makes NelBcKiling a very appetizing 
system. As a suppon offieer, you can easily diagno.se a 
protdem, and you can be guaranteed that if software wtirks 
fine on one client it will Ixt replicated on all other clients using 
the same NciIkkh image. Thus, (m>any problem.s will be due 
either to hardware failures or user's settings, not system OS 
problems. Reixjot tlie client or login as a known working user 
and you can troubleshoot very easily. As a supp()rt technician, 
this makes so much sense and makes your life .so muc:h easier, 
making NetBoot a vital system of def)!oyment for any 
network, large or small. 

Til I 
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SPOTLIGHT « 


Steve Modica, 

CTO, Small Tree 
Communications 


Your Company: 

Stiiall Tree Communicntiom. 1 founded Small Tree with a 
group of S former SGI employees a,s SGI augured in Ixick in 
SeplemlKT of 2003. 

What do you do? 

I am CTO. I keep an eye on prcxiucts, partners, 
technologies and trends to figure out what we ran do, whai we 
should lioing and what will Ix^ successful in the inarket, 1 
spend a lot of lime talking to and presenting to customers as 
well as asking customers and resellers what they need. 

How long have you been doing what you do? 

I started in the computer industry back in 1988 at Herstal 
Automation. 1 was doing device driver work for HP UNIX 
systems in 1990 for them. I spent IJ years at SGI prior to 
starting Small Tree. 

Your first computer: 

An Atari ST 5U, followed closely by an 8088 based XT 
Tur[x> that could nin at lOMh^:. 

Are you Mac-only, or a multi-platform person? 

1 Ijccamc Mac only once I started Small 1Vee. For the last 
couple years that I was at SGI, I used my own persona! laptop 
to do ail my work. 

What attracts you to working on the Mac? 

'I he completeness and e^se of the GUI (the OS in general 
in fact) combined with the underlying power and llexibiliiy of 
the BSD UNIX mnning underneath it. 

Pve hardly had to iliink about configumtum issues even 
though I u.se llie computer in many different network settings. 
At the same time, it ha.s powerful tools like Isof and ktrace Uiul 
I was used to using on my SGI desktop years ago. 

What's the coolest thing about the Mac? 

'lb me, the coolest thing is that it's an easy to use Unix 
machine wiih all ihc apps I need IGs everything SGI should 
have lycen 10 years ago. 


witlxTut sc^rewing it up. par would let you trace the scheduler's 
activity, sar (and later Perfbniiaiice Co-Pilor) would give very 
detailed performance information. OS X Ls missing a lot of that 
stuff. 

What^s the coolest tech thing youVe done using OS X? 

I've setup my matriiine as a bridge l>erween wired and 
wireless networks on extremely short notice. Sint:e the system 
is Unix, it was pretty easy for me to figure it out. 

Ever? 

Showing DVD movies on the wall using my LCD projector 
got the biggest rise out of my kids, so iliat wins hands down, 

Where can we see a sample of your work? 

Mast of the stuff 1 have a hand in today is on Small Tree's 
website: http://5Tnall-free.coni. I spend a lot of Time worrying 
about the GUIs and how easy the various prcxlucts vvill lx; for 
customers to figure out. 

The next way Tm going to impact IT/OS X/the Mac 
universe is: 


If I could change one thing about Apple/OS X, Td: 

SGI systems running Irix had some awesome debugging 
features, icrash would let you interrogate the nmntng kernel 


Making high speed iSCSI availble for things like video 
editing. 
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Over 4000 Mac-friendly products + Award-winning customer sen/ice! 






i Microsoft Office 

* Essential software for 
school, home, or work - 
starting at only $145.99! 


Notebook Cooler 

Antec notebook cooler - 
great for summer heat! 


MacBook Bundles & Back To School Specials! 

Price reduced MacBooks from $999! 


Pro Hardware & Software. 


Uf)grade Qptbns tor G3, 
G4, G5, and Intel Macs! 


Xsetve, Xserve RAID, 
Xserve Resources. 


LaCie Drives 

tncluding ttie bus-pow¬ 
ered. portable Rugged 
Drive with LJSB 2.0, 
Firewire 400, and 
Rrewire 800! 




Parquets 
Desktop for Maf 


HAVE MORE FUN WITH YOUR MAC! 

Ctxx;k oul ouf btog. Barkings - updated daily with Mac nesft®. 
views, lips cind tricks: Blog-smattdog.com 

Take your knowledge to the next level and subscribe to our 
popubr free newsletters, Kibblf^ ^ Bytes and Tech tails: 
Smalldog.com/learn.html 


Parallels Desktop 

Combine with Windows lo run Windows 
XR Vista, Of Linux on your Mac! 
Limited offer; Get Parallets on a reus¬ 
able Kingston flash key for only $69.99! 


iiexl carder ^ Sl/>7p/y 
Coi/pGii {lade 

jC €>/>? / 

Coupon good through 9/31/07 
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TMINCS MADE IN CHINA 


COMPRESSED BY 


STUFFIT DELUXE 
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